Insights
O módulo Insights realiza análises síncronas dos dados recebidos, retornando score, status e os insights em poucos segundos.
Funcionamento do Módulo Insights
InsightsO módulo Insights opera de forma síncrona, realizando a análise dos dados imediatamente após o recebimento de uma solicitação. Esse processo envolve o cruzamento de múltiplas informações relevantes, com o objetivo de calcular o score, determinar o status e os insights da análise.
A resposta da análise é retornada em questão de segundos, permitindo decisões rápidas e integradas ao fluxo da aplicação, sem a necessidade de processamento assíncrono ou espera prolongada.
POST Response
Representa a resposta de execução da integração no módulo Insights. Caso tenha contratado mais de um módulo, pode receber todos de uma vez. O que não tiver contratado, não será retornado.
Result
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| executionId | ID da execução | Guid | Sim |
| analysisId | ID da análise | Guid | Sim |
| transactionId | ID da transação | String | Sim |
| insights | Resultados de insights | Insights Result | Não |
Insights Result
Representa os insights gerados pela análise.
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| status | Status dos insights | String | Sim |
| result | Lista de insights gerados | Insight Array | Não |
Insight
Representa um insight gerado pela análise.
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| code | Código do insight | String | Sim |
| description | Descrição do insight | String | Sim |
| type | Tipo do insight | String | Sim |
| category | Categoria do insight | String | Sim |
| relevance | Relevância do insight | String | Sim |
| relatedTo | Entidade ou elemento relacionado ao insight | String Array | Sim |
JSON
{
"executionId": "string",
"analysisId": "string",
"transactionId": "string",
"insights": {
"status": "string",
"result": [
{
"code": "string",
"description": "string",
"type": "string",
"category": "string",
"relevance": "string",
"relatedTo": [
"string"
]
}
]
}
}GET Response
Representa a resposta de execução da consulta da análise.
Result
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| analysisId | ID da análise | Guid | Sim |
| transactionId | ID da transação | String | Sim |
| insights | Resultados de insights | Insights Result | Não |
Insights Result
Representa os insights gerados pela análise.
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| status | Status dos insights | String | Sim |
| result | Lista de insights gerados | Insight Array | Não |
Insight
Representa um insight gerado pela análise.
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| code | Código do insight | String | Sim |
| description | Descrição do insight | String | Sim |
| type | Tipo do insight | String | Sim |
| category | Categoria do insight | String | Sim |
| relevance | Relevância do insight | String | Sim |
| relatedTo | Entidade ou elemento relacionado ao insight | String Array | Sim |
JSON
{
"analysisId": "string",
"transactionId": "string",
"insights": {
"status": "string",
"result": [
{
"code": "string",
"description": "string",
"type": "string",
"category": "string",
"relevance": "string",
"relatedTo": [
"string"
]
}
]
}
}Response com erro
Representa os detalhes de um problema retornado pela API em caso de erro.
| Campos | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| type | URI que identifica o tipo de problema específico. Pode ser usado para categorizar o erro. | String | Não |
| title | Título descritivo do problema | String | Sim |
| status | Código de status HTTP associado ao problema | Integer | Sim |
| errors | Erros de validação | Object | Sim |
| instance | URI que identifica a instância específica do problema | String | Não |
Tabela de Códigos HTTP
Representa os possíveis códigos HTTP de um problema retornado pela API em caso de erro.
| Código | Nome | Significado |
|---|---|---|
| 400 | Bad Request | A requisição foi malformada ou contém parâmetros inválidos |
| 401 | Unauthorized | O cliente não está autenticado ou o token é inválido/expirado |
| 500 | Internal Server Error | Erro inesperado no servidor |
| 503 | Service Unavailable | O serviço está temporariamente indisponível ou em manutenção |
JSON
{
"errors": {
"string": [
"string"
]
},
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"traceId": "string"
}{
"type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
"title": "Internal server error",
"status": 500,
"detail": "The server encountered an unexpected condition that prevented it from fulfilling the request",
"traceId": "string"
}Updated about 2 months ago
