Todas as respostas estão em formato JSON.
Você recebe respostas em 2 momentos:
Resposta à requisição da consulta - ocorre imediatamente após fazer uma requisição
Resposta com o resultado da consulta - informada por callback ou consultando a API de resposta do Plexi
Resposta à requisição da consulta
Há 2 tipos de respostas a uma requisição:
Status 201 - solicitação recebida
Exemplo de resposta:
A consulta recebida com sucesso e será processada. Com o ID retornado você pode consultar se já houve resposta.
{ "requestId": "1fdd4247-4f98-4113-887a-b182117b0e42" }
O requestId é o identificador único da requisição.
Status 422 - solicitação contém erros
Exemplo de resposta:
Significa que ocorreu um erro de validação dos dados enviados.
{ "message": "The given data was invalid.", "errors": { "cpf": [ "O campo cpf é obrigatório." ], "nome": [ "O campo name é obrigatório." ] } }
Resposta com o resultado da consulta
Respostas a requisições que possuem URL de callback
O Plexi enviará na URL de callback o resultado da consulta assim que ele estiver pronto.
Ao enviar a resposta, o Plexi espera um retorno com status 200. Caso isso não aconteça, uma nova tentativa de envio da resposta é feita 30 segundos após o recebimento do primeiro retorno.
Caso ocorra algum problema em sua URL, ainda assim você poderá ver o resultado, seguindo o passo da situação a seguir.
Respostas a requisições que NÃO possuem URL de callback
Caso não tenha informado uma URL de callback, você poderá consultar a API do Plexi para obter o resultado.
Veja a seção API de resultados das consultas para saber como obter o resultado de uma consulta.
Informações importantes
O tempo necessário para o resultado para ficar disponível depende da fonte original da consulta.