post https://plataforma.bigdatacorp.com.br/monitoramento/diferencas
Descrição
Nesta ferramenta, é possível verificar as mudanças entre diferentes resultados das APIs de Enriquecimento. Pode ser usado a partir de um SubscriptionId, de modo que será feita a comparação entre o registro mais recente e o mais antido referente a este monitoramento. Também é aceito o uso de dois identificadores de chamada (QueryId) para a realização da comparação.
Parâmetros de Entrada
A tabela a seguir descreve os parâmetros de entrada deste método, indicando se são obrigatórios ou não.
| Campo | Obrigatório? | Valores Possíveis | Descrição |
|---|---|---|---|
| AccessToken | Sim | Token de autenticação nas APIs da Plataforma de Dados. Também pode ser informado no cabeçalho da requisição. | Token JWT |
| SubscriptionId | Não | Ids de monitoramentos | O SubscriptionId que deseja ser comparado (a diferença é feita em relação ao último resultado dessemonitormento) |
| QueryId1 e QueryId2 | Não | Os QueryIds de duas chamadas | Query Ids que deseja fazer a comparação |
Retorno
A tabela a seguir descreve os campos do objeto de retorno desse método.
| Campo | Descrição |
|---|---|
| ResultStatus | Status final da operação |
| ListenedFieldsByDataset | Objeto relacionando os campos monitorados em cada dataset. Só possuirá um valor caso o SubscriptionId seja fornecido. |
| QueriesDatesByQueryId | Datas referentes às consultas que foram comparadas |
| DiffDetails | Objeto contendo as alterações encontradas para cada dataset. São utilizados diferentes métodos de comparação. |
| DiffDetails.SimpleJsonStringComparator | Comparação textual entre os resultados de cada dataset. Retorna se houve ou não mudança no objeto. |
| DiffDetails.RecursiveGenericComparator | Comparação baseada na avaliação recursiva dos campos presentes nos objetos de saída de cada dataset. Retorna uma lista com as musdanças encontradas por dataset. |
Exemplos
A seguir estão alguns exemplos de uso deste endpoint.
POST: https://plataforma.bigdatacorp.com.br/monitoramento/diferencas
Request:
{
"AccessToken": "<YOUR_ACCESS_TOKEN>",
"SubscriptionId": "66eb250c116bae298ca4daef"
}
Response:
{
"SubscriptionDiff": {
"ResultStatus": "DONE",
"ListenedFieldsByDataset": {
"basic_data": [
"TaxIdStatus"
]
},
"QueriesDatesByQueryId": {
"9766a2c8-1556-4597-8c4c-6fc0031356cc": "2024-08-05T21:13:36.868196Z",
"50c1568b-e59d-43bd-99dc-b0c64a2b7459": "2024-08-12T21:08:11.0823583Z"
},
"DiffDetails": {
"SimpleJsonStringComparator": {
"basic_data": true
},
"RecursiveGenericComparator": {
"basic_data": [
"[Field]: BasicData.TaxIdStatus - [Changed]: from REGULAR to PENDENTE DE REGULARIZACAO"
]
}
}
},
"QueryId": "b782cdd4-81be-4ce4-a360-5b0487418fc2",
"ElapsedMilliseconds": 2118,
"QueryDate": "2024-08-19T18:13:39.2413226+00:00",
"Status": {
"api": [
{
"Code": 0,
"Message": "OK"
}
]
}
}
Request:
{
"AccessToken": "<YOUR_ACCESS_TOKEN>",
"QueryId1": "9766a2c8-1556-4597-8c4c-6fc0031356cc",
"QueryId2": "50c1568b-e59d-43bd-99dc-b0c64a2b7459"
}
Response:
{
"SubscriptionDiff": {
"ResultStatus": "DONE",
"ListenedFieldsByDataset": {},
"QueriesDatesByQueryId": {
"9766a2c8-1556-4597-8c4c-6fc0031356cc": "2024-08-05T21:13:36.868196Z",
"50c1568b-e59d-43bd-99dc-b0c64a2b7459": "2024-08-12T21:08:11.0823583Z"
},
"DiffDetails": {
"SimpleJsonStringComparator": {
"basic_data": true
},
"RecursiveGenericComparator": {
"basic_data": [
"[Field]: BasicData.TaxIdStatus - [Changed]: from REGULAR to PENDENTE DE REGULARIZACAO"
]
}
}
},
"QueryId": "b782cdd4-81be-4ce4-a360-5b0487418fc2",
"ElapsedMilliseconds": 2118,
"QueryDate": "2024-08-19T18:13:39.2413226+00:00",
"Status": {
"api": [
{
"Code": 0,
"Message": "OK"
}
]
}
}