Documentação da API · Centurion Agro Intelligence

APIs para integração com Consulta CAR e Análise Socioambiental.

Esta documentação descreve os contratos REST das APIs Centurion para Consulta CAR e Consulta Socioambiental, incluindo autenticação, parâmetros, formatos de resposta e exemplos de requisição.

Autenticação & Convenções

Autenticação, headers e envelope padrão

Todas as APIs utilizam autenticação via Bearer JWT. O token será disponibilizado pela Centurion Agro Intelligence e deve ser enviado no header HTTP:
Authorization: Bearer <seu-token-jwt> Content-Type: application/json Accept: application/json
As respostas seguem um envelope padrão, independente do recurso:
{ "requestId": "c8a9b3f1-2d44-4e0c-b6df-2a77c9a1f0b1", "message": "Consulta realizada com sucesso", "code": 200, "timestamp": "2024-12-15T13:37:00Z", "data": { ... objeto específico da API ... } }
Campos do envelope:
  • requestId (string) – identificador único da requisição na plataforma Centurion.
  • message (string) – mensagem de status legível.
  • code (number) – código numérico alinhado ao HTTP status (ex.: 200, 400, 401).
  • timestamp (string, ISO-8601) – data/hora da resposta no servidor.
  • data – payload específico de cada API (Consulta CAR, Socioambiental, etc.).
API Consulta CAR

Consulta de imóvel rural a partir do código do CAR

Retorna informações geoespaciais e cadastrais de um imóvel rural a partir de um código de CAR, incluindo geometria, situação e indicadores básicos.

GET /api/v1/car

Consulta dados do CAR a partir do parâmetro carCode.

Parâmetros de query
Nome Tipo Obrigatório Descrição
carCode string required Código do Cadastro Ambiental Rural (CAR) a ser consultado.
Exemplo: RS-4305108-1234567890
Exemplo de requisição HTTP
GET https://centurion-agro.api.com/api/v1/car?carCode=RS-4305108-1234567890 Authorization: Bearer <seu-token-jwt> Accept: application/json
Exemplo de requisição via cURL
curl -X GET "https://centurion-agro.api.com/api/v1/car?carCode=RS-4305108-1234567890" \ -H "Authorization: Bearer <seu-token-jwt>" \ -H "Accept: application/json"
Estrutura de resposta (data)
  • geometry (objeto) – geometria do imóvel (GeoJSON).
  • cityName (string) – nome do município.
  • carCode (string) – código do CAR consultado.
  • type (string) – tipo de imóvel / categoria cadastrada.
  • situation (string) – situação do CAR (ativo, pendente, cancelado, etc.).
  • condition (string) – condição do cadastro conforme órgão ambiental.
  • areaHa (number) – área total do imóvel em hectares.
  • stateAcronym (string) – UF, ex.: RS, MT, BA.
Exemplo de resposta (200)
{ "requestId": "c8a9b3f1-2d44-4e0c-b6df-2a77c9a1f0b1", "message": "Consulta CAR realizada com sucesso", "code": 200, "timestamp": "2024-12-15T13:37:00Z", "data": { "geometry": { "type": "MultiPolygon", "coordinates": [ /* ... coordenadas ... */ ] }, "cityName": "Cerro Largo", "carCode": "RS-4305108-1234567890", "type": "IMOVEL_RURAL", "situation": "ATIVO", "condition": "REGULAR", "areaHa": 125.73, "stateAcronym": "RS" } }
API Consulta Socioambiental

Análise de sobreposição com camadas socioambientais

A API de Consulta Socioambiental realiza o cruzamento da geometria enviada (GeoJSON) com diversas camadas (como Terras Indígenas, Moratória da Soja, áreas protegidas, etc.), retornando níveis de alerta, restrições e detalhes de sobreposição.

POST /api/v1/socioenvironmental

Consulta as camadas socioambientais relacionadas a uma geometria enviada em formato GeoJSON.

Corpo da requisição (JSON · GeoJSON)
O corpo da requisição deve conter um objeto GeoJSON válido (por exemplo, um Polygon ou MultiPolygon) representando a área a ser analisada.
POST https://centurion-agro.api.com/api/v1/socioenvironmental Authorization: Bearer <seu-token-jwt> Content-Type: application/json Accept: application/json { "type": "Polygon", "coordinates": [ [ [-54.12345, -28.12345], [-54.23456, -28.12345], [-54.23456, -28.23456], [-54.12345, -28.23456], [-54.12345, -28.12345] ] ] }
Exemplo de requisição via cURL
curl -X POST "https://centurion-agro.api.com/api/v1/socioenvironmental" \ -H "Authorization: Bearer <seu-token-jwt>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "type": "Polygon", "coordinates": [ [ [-54.12345, -28.12345], [-54.23456, -28.12345], [-54.23456, -28.23456], [-54.12345, -28.23456], [-54.12345, -28.12345] ] ] }'
Estrutura de resposta (data)
O campo data é uma lista de camadas, onde cada item representa o resultado para uma camada socioambiental específica (ex.: Moratória da Soja, Terras Indígenas, etc.).
  • layer – metadados da camada consultada:
    • code (string) – código interno da camada, ex.: "TERRA_INDIGENA".
    • name (string) – nome da camada, ex.: "Terras indígenas".
    • updatedLayerDate (string, ISO-8601) – data da última atualização da camada.
    • font – origem da camada:
      • name (string) – fonte, ex.: "FUNAI".
      • url (string) – URL oficial da fonte de dados.
      • createdAt (string) – data de cadastro da fonte no sistema.
  • results (array) – lista de sobreposições encontradas para a camada.
  • totalOverlaps (number / null) – total de sobreposições agregadas (quando aplicável).
  • hasOverlap (boolean) – indica se há sobreposição da geometria com a camada.
  • alertLevel (string) – nível de alerta consolidado (BAIXO, MÉDIO, ALTO).
  • hasRestriction (boolean) – indica se a camada representa restrição relevante.
  • status (string / null) – campo livre para status adicional.
  • totalRestrictionArea (string) – área total de restrição em hectares (texto, ex.: "2656.261536154148").
Estrutura de cada item em results
  • type (string / null) – tipo de feature geoespacial (quando aplicável).
  • geometry – geometria da feature (pode ser nulo se omitido).
  • properties (array) – lista de objetos com atributos específicos da camada.
Exemplo de resposta (trecho)
{ "requestId": "a1b2c3d4-1234-5678-9abc-def012345678", "message": "Consulta socioambiental realizada com sucesso", "code": 200, "timestamp": "2024-12-15T13:45:00Z", "data": [ { "layer": { "font": { "createdAt": "2024-06-27T17:21:14.956", "name": "Teste", "url": "Url" }, "code": "MORATORIA_SOJA", "name": "Moratória da Soja", "updatedLayerDate": "2020-05-11T11:38:20.239659" }, "results": [], "totalOverlaps": null, "hasOverlap": false, "alertLevel": "BAIXO", "hasRestriction": false, "status": null, "totalRestrictionArea": "0.0" }, { "layer": { "font": { "createdAt": "2025-06-20T11:00:58", "name": "FUNAI", "url": "https://www.gov.br/funai/pt-br/atuacao/terras-indigenas/geoprocessamento-e-mapas" }, "code": "TERRA_INDIGENA", "name": "Terras indígenas", "updatedLayerDate": "2024-12-16T00:00:00" }, "results": [ { "type": null, "properties": [ { "fase": "Regularizada", "unidade_administrativa": "COORDENACAO REGIONAL DE PASSO FUNDO", "area_intersecao_ha": 1829.6667642886177, "protocoloCliente": 469, "area_geometria_ha": 32514.34756288769, "nome": "Votouro", "codigoSobreposicao": "6g4ef1hj5", "areaTotalFeatureHa": 3327.1275389471493, "codigo_ti": "49201", "etnia": "Kaingang", "nivelAlerta": "ALTO", "percentualSobreposicaoGeometria": 5.6273, "codigo_sobreposicao": "6g4ef1hj5", "id": "834191a4...", "percentual_sobreposicao_geometria": 5.6273, "areaHa": 1829.6667642886177, "modalidade": "Tradicionalmente ocupada", "area_feature_ha": 3327.1275389471493, "areaGeometriaAnalisadaHa": 32514.34756288769 } ], "geometry": null, "message": null, "id": null } ], "totalOverlaps": null, "hasOverlap": false, "alertLevel": "ALTO", "hasRestriction": true, "status": null, "totalRestrictionArea": "2656.261536154148" } ] }
API Territory Intelligence

Territory Intelligence (IA aplicada ao Agro)

A API de Territory Intelligence combina múltiplas fontes de dados (CAR, socioambiental, financeiro, documentos, laudos e modelos de IA) em um diagnóstico único e acionável do imóvel ou carteira.

API Premium /api/v1/territory-intelligence

Em breve a documentação pública completa desta API estará disponível aqui.

Em breve documentação. Para mais informações sobre o contrato, modelos de dados, integrações específicas e condições comerciais, entre em contato com nosso time:
# Em breve: POST https://centurion-agro.api.com/api/v1/territory-intelligence Authorization: Bearer <seu-token-jwt> Content-Type: application/json { // payload com dados do imóvel, documentos, laudos e parâmetros de análise }