/api/CadastroAmbientalRural
💡 O endpoint
/api/CadastroAmbientalRural
permite consultar informações detalhadas sobre imóveis rurais registrados no Cadastro Ambiental Rural (CAR).
Introdução
A API CAR - Cadastro Ambiental Rural oferece informações completas sobre propriedades rurais, incluindo:
- Dados cadastrais e ambientais do imóvel;
- Situação do cadastro e histórico de retificações;
- Informações detalhadas sobre reservas legais, vegetação nativa e uso do solo.
Essa API é ideal para onboarding de clientes e fornecedores e compliance/ESG.
URL Base
https://apiv3.directd.com.br
Endpoint
GET /api/CadastroAmbientalRural
Esse endpoint retorna informações detalhadas sobre um imóvel rural cadastrado no CAR.
Regras
- Apenas um número de inscrição no CAR deve ser enviado por requisição.
- É possível incluir a geração de um comprovante PDF por um custo adicional.
Autenticação
A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401
).
Regras de Autenticação
- O
TOKEN
deve ser incluído como parâmetro obrigatório. - Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.
Campos da API
Dados Retornados
- Inscrição CAR: Número de inscrição no Cadastro Ambiental Rural.
- Situação do Cadastro: Status cadastral do imóvel no CAR.
- Área Total: Área registrada do imóvel.
- Município: Município de localização do imóvel.
- UF: Estado do imóvel.
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
NumeroCAR | string | Sim | Número de inscrição no CAR. |
TOKEN | string | Sim | Token de autenticação. |
GERARCOMPROVANTE | boolean | Não | Indica se deve gerar um comprovante em PDF. |
Exemplo de Requisição
Usando cURL
curl -X 'GET' \
'https://apiv3.directd.com.br/api/CadastroAmbientalRural?NumeroCAR=123456789&TOKEN=SEUTOKENAQUI' \
-H 'accept: application/json'
Erros Comuns
Código | Descrição |
---|---|
400 | Requisição inválida. |
401 | Não autenticado. |
404 | Registro não encontrado. |