Respostas
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. Também é incluído na resposta o requestId e o endpoint, que representa o ID da consulta e o nome da consulta respectivamente.
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 https://crawly.atlassian.net/wiki/spaces/PLEXIAPI/pages/614760479 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.