API Rest para desenvolvedores

Uma das grandes novidades do Plugin Rifa – Drope, é a possibilidade de usar a RIFA API, para criar suas próprias regras de negócio ou integrações usando as funcionalidades da Rifa.

Se você não tem conhecimento técnico, pode ignorar essa sessão, por que ela tem o propósito de auxiliar apenas desenvolvedores.

Para acessar a API o endpoint é https://seudominio.com.br/wp-json/pluginrifa/v2/infos/?rifa=IDRIFA

Obviamente, você deve trocar o seudominio.com.br pelo nome do domínio onde está instalado o seu WordPress, bem como substituir IDRIFA pelo ID do produto WooCommerce que configurou e/ou vendeu números da Rifa.

Exemplo de conexão com o endpoint através de Ajax (Axios):

				
					// Fazer a conexão enviando o ID da Rifa
axios.get('https://seudominio.com.br/wp-json/pluginrifa/v2/infos/?rifa=IDPRODUTO')
  .then(function (response) {
    // Sucesso
    console.log(response);
  })
  .catch(function (error) {
    // Algo deu errado
    console.log(error);
  })
  .then(function () {
    // Será executado em todo caso
  });
				
			

A partir da versão 3.0.4 foram adicionados uma nova key para exibir os participantes da Rifa. Os status possíveis são:

  • on-hold = Aguardando
  • pending = Aguardando pagamento
  • processing = Processando
  • completed = Concluído
  • rifa-presencial = Reserva feita pelo plugin


Qualquer outro status, o pedido não será retornado pela API, por exemplo, se estiver com status de cancelado.

Se você quiser acessar a API internamente através do seu tema, poderia fazer algo parecido com o exemplo abaixo:

				
					<?php

$request = new WP_REST_Request( 'GET','/pluginrifa/v2/infos' );
$request->set_query_params( [ 'rifa' => $id_produto ] );
$response = rest_do_request( $request );
$server = rest_get_server();
$json = $server->response_to_data( $response, false );

$obj = json_decode($json);

// SALVAR OS PARTICIPANTES
$participantes = array();
$participantes = $obj->participantes;
				
			

Para adicionar cotas ao carrinho você só precisa de um formulário POST na sua página, com os mesmos inputs com os names descritos abaixo:

				
					<form method="post" action="<?php echo get_option('home') ?>/?add-to-cart=IDPRODUTO">

  <input type="hidden" id="quantidadeCotasEscolhidasInput" name="quantidade_cotas_escolhidas_input" value="QUANTIDADE">
  <input type="hidden" id="cotasEscolhidasInput" name="cotas_escolhidas_input" value="COTASESCOLHIDAS">

</form>
				
			

Claro, substituindo pelo valores corretos.

As cotas precisam estar separadas por vírgula, mesmo a última da string, por exemplo “0025,0030,0055,0099,”.

O que você achou dessa documentação?
Atualizado em março 26, 2023