Integração APIVeículosCSV

Comunicação de Venda

Esta API retorna último registro de CSV do veículo.

Montando a requisição

Método da requisição

GET

Endereço da requisição

Principal:

https://api.activethread.com.br/detran/v1/csv/AAA1B11

Secundário:

https://api.detran.app.br/detran/v1/csv/AAA1B11

Parâmetros da requisição

Via URL

  • https://api.detran.app.br/detran/v1/csv/AAA1B11?at=XPTO

Via Cabeçalho

  • Authorization: XPTO

Respostas da requisição

200 - Sucesso

Observação: Os dados abaixo são apenas demonstrativos, com a finalidade de mapeamento da estrutura. Por isso, de forma alguma representam a realidade.

{
    "status": "SUCCESS",
    "result": {
        "alertas": {
            "statusRetorno": {
                "codigo": "1",
                "descricao": "CONSULTA CONCLUIDA COM SUCESSO"
            },
            "placa": "",
            "chassi": "",
            "quantidadeOcorrencias": "2",
            "ocorrencias": [
                {
                    "severidade": "2",
                    "mensagem": "ATENÇÃO PARA LAUDO CSV DO VEICULO",
                    "descricao": "LAUDO CSV: INFORMACAO OCULTADA"
                },
                {
                    "severidade": "2",
                    "mensagem": "ATENÇÃO PARA LAUDO CSV DO VEICULO",
                    "descricao": "LAUDO CSV: INFORMACAO OCULTADA"
                }
            ]
        },
        "csv": [
            {
                "chassi": "",
                "identificacaoCsv": "INFORMACAO OCULTADA",
                "tipoCsv": "",
                "dataInspecao": "",
                "nomeproprietario": "",
                "municipioUf": "",
                "itl": "",
                "itlCnpj": "",
                "escopo": "",
                "mensagem": "",
                "imageFile": {
                    "mimeType": "image/png",
                    "fileBase64": ""
                },
                "pdfFile": {
                    "mimeType": "application/pdf",
                    "fileBase64": ""
                }
            },
            {
                "chassi": "",
                "identificacaoCsv": "INFORMACAO OCULTADA",
                "tipoCsv": "",
                "dataInspecao": "",
                "nomeproprietario": "",
                "municipioUf": "",
                "itl": "",
                "itlCnpj": "",
                "escopo": "",
                "mensagem": "",
                "imageFile": {
                    "mimeType": "image/png",
                    "fileBase64": ""
                },
                "pdfFile": {
                    "mimeType": "application/pdf",
                    "fileBase64": ""
                }
            }
        ],
        "baseNacional": {
            "statusRetorno": {
                "codigo": "1",
                "descricao": "CONSULTA CONCLUIDA COM SUCESSO"
            },
            "restricoes": {
                "existeRestricaoRouboFurto": "0",
                "marcamodeloBaixado": "0",
                "existeRestricaoRenajud": "0",
                "existeRestricaoGeral": "1",
                "mensagensRestricoes": [
                    {
                        "mensagem": "EXISTE INDICADOR DE MULTA RENAINF"
                    }
                ]
            },
            "chassi": "INFORMACAO OCULTADA",
            "placa": "AAA1B11",
            "uf": "RJ",
            "motor": "",
            "caixaCambio": "",
            "renavam": "INFORMACAO OCULTADA",
            "municipio": "ITABORAI",
            "situacaoVeiculo": "EM CIRCULACAO",
            "tipoMarcacaoChassi": "",
            "tipoMontagem": "",
            "tipoMarcamodelo": "AUTOMOVEL",
            "marcaModelo": "GM/ZAFIRA ELEGANCE",
            "especieMarcamodelo": "",
            "tipoCarroceria": "",
            "corMarcamodelo": "",
            "anoModelo": "2010",
            "anoFabricacao": "2009",
            "dataLimiteRestricaoTributaria": "",
            "potenciaMarcamodelo": "140",
            "cilindrada": "",
            "combustivel": "",
            "cmt": "",
            "pbt": "2",
            "capamunicipioCarga": "",
            "procedencia": "NACIONAL",
            "categoriaMarcamodelo": "",
            "nomeproprietario": {
                "documento": "INFORMACAO OCULTADA",
                "nome": "INFORMACAO OCULTADA"
            },
            "numeroCarroceria": "",
            "quantidadePassageiros": "7",
            "numeroEixos": "0",
            "numeroEixoTraseiro": "",
            "numeroEixoAuxiliar": "",
            "tipoDocumentoImportador": "",
            "numeroIdentificacaoImportador": "",
            "codigoOrgaoSrf": "",
            "numeroReda": "",
            "numeroDi": "",
            "dataRegistroDi": "",
            "tipoDocumentoFaturado": "",
            "numeroIdentificacaoFaturado": "",
            "ufFaturamento": "",
            "tipoOperacaoImportacaoMarcamodelo": "",
            "numeroProcessoImportacao": "",
            "dataUltAtualizacao": "EM CIRCULACAO",
            "dataEmplacamento": "",
            "informacoesAvulsas": [
                {
                    "codigo": "1",
                    "descricao": "ALARME:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                },
                {
                    "codigo": "2",
                    "descricao": "ROUBO/FURTO:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                },
                {
                    "codigo": "3",
                    "descricao": "COMUNICACAO DE VENDA:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                },
                {
                    "codigo": "6",
                    "descricao": "PENDENCIA EMISSAO:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                },
                {
                    "codigo": "7",
                    "descricao": "RECALL MONTADORA:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                },
                {
                    "codigo": "8",
                    "descricao": "RENAJUD:",
                    "valor": "SEM INDICACAO/NADA CONSTA"
                }
            ],
            "logoFabricante": {
                "imagemBase64": "",
                "imagemUrl": ""
            },
            "alertaInformativo": "",
            "offLine": "0",
            "dataEmissaoCrlv": "",
            "numeroViaCrlv": "",
            "dataEmissaoUltimoCrv": "16/09/2022",
            "numeroSequenciaCrv": "",
            "numeroCrv": "",
            "numeroViaCrv": "",
            "codigoSegurancaCrv": "",
            "marca": "GM",
            "modelo": "ZAFIRA ELEGANCE",
            "documentoProprietario": "INFORMACAO OCULTADA",
            "cor": "PRATA",
            "especie": "PASSAGEIRO",
            "nomeProprietario": "INFORMACAO OCULTADA",
            "tipoProprietario": "Proprietário",
            "tipo": "AUTOMOVEL",
            "numeroDocumentoProprietario": "INFORMACAO OCULTADA",
            "proprietario": {
                "nome": "INFORMACAO OCULTADA",
                "documento": "INFORMACAO OCULTADA",
                "tipoDocumento": "CPF"
            },
            "restricaoAdminisrativa": "",
            "restricaoAmbiental": "",
            "restricaoArrendatario": "",
            "restricaoDataInclusao": "",
            "restricaoDocArrendatario": "",
            "restricaoFinanceira": "NAO",
            "restricaoGeral": "SIM",
            "restricaoGuincho": "",
            "restricaoJudicial": "",
            "restricaoVeiculoBaixado": "NAO",
            "restricaoNomeAgente": "",
            "restricaoRenajud": "NAO",
            "restricaoRouboFurto": "NAO",
            "restricaoTributaria": "",
            "restricaoAlarme": "NAO",
            "restricaoComunicacaoVenda": "NAO",
            "restricaoPendenciaEmissao": "NAO",
            "restricaoRecall": "NAO"
        },
        "multasRenainf": [
            {
                "cnhCondutor": {
                    "impedimento": null,
                    "pontos": 0,
                    "portaria": null,
                    "registro": ""
                },
                "cnhInfrator": {
                    "impedimento": null,
                    "pontos": 0,
                    "portaria": null,
                    "registro": ""
                },
                "pagamento": {
                    "dataPagamento": "",
                    "dataRegistro": "",
                    "ufPagamento": "",
                    "valorPago": ""
                },
                "autoInfracao": "INFORMACAO OCULTADA",
                "codigoInfracao": "7455",
                "codigoMunicipioInfracao": "",
                "codigoOrgaoAutuador": "",
                "dataCadastroInfracao": "09/12/2023",
                "dataEmissaoNotificacao": "09/12/2023",
                "dataEmissaoPenalidade": "",
                "dataInfracao": "03/12/2023",
                "descricao": "TRANSITAR EM VELOCIDADE SUPERIOR A MAXIMA PERMITIDA EM ATE 20%",
                "horaInfracao": " 15:49",
                "limitePermitido": "",
                "localInfracao": "",
                "marcaModelo": "",
                "medicaoConsiderada": "",
                "medicaoReal": "",
                "orgaoAutuador": "PREF. DE RJ RIO DE JANEIRO",
                "tipo": "",
                "ufOrgaoAutuador": "RJ",
                "valor": "130"
            }
        ]
    }
}

400 - Requisição inválida

Exemplo:

{
  "message": "Por favor, informe uma placa válida."
}

401 - Não autorizado

{
  "message": "Não autorizado."
}

403 - Acesso negado

{
  "message": "Acesso negado!"
}

Exemplos da requisição - Autenticação via URL

HTTP

GET /detran/v1/csv/AAA1B11 HTTP/1.1
Host: api.activethread.com.br

cURL

curl --location 'https://api.activethread.com.br/detran/v1/csv/AAA1B11

JavaScript

const requestOptions = {
  method: "GET",
  redirect: "follow",
};
 
fetch(
  "https://api.activethread.com.br/detran/v1/csv/AAA1B11?at=XPTO",
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

NodeJs

const axios = require("axios");
 
let config = {
  method: "get",
  maxBodyLength: Infinity,
  url: "https://api.activethread.com.br/detran/v1/csv/AAA1B11?at=XPTO",
  headers: {},
};
 
axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

PHP

<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.activethread.com.br/detran/v1/csv/AAA1B11?at=XPTO',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));
 
$response = curl_exec($curl);
 
curl_close($curl);
echo $response;

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.activethread.com.br/detran/v1/csv/AAA1B11?at=XPTO")
  .asString();

Python

import requests
 
url = "https://api.activethread.com.br/detran/v1/csv/AAA1B11?at=XPTO"
 
payload = {}
headers = {}
 
response = requests.request("GET", url, headers=headers, data=payload)
 
print(response.text)

Exemplos da requisição - Autenticação via Cabeçalho

HTTP

GET /detran/v1/csv/AAA1B11 HTTP/1.1
Host: api.activethread.com.br
Authorization: XPTO

cURL

curl --location 'https://api.activethread.com.br/detran/v1/csv/AAA1B11' \
--header 'Authorization: XPTO'

JavaScript

const myHeaders = new Headers();
myHeaders.append("Authorization", "XPTO");
 
const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow",
};
 
fetch("https://api.activethread.com.br/detran/v1/csv/AAA1B11", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

NodeJs

const axios = require("axios");
 
let config = {
  method: "get",
  maxBodyLength: Infinity,
  url: "https://api.activethread.com.br/detran/v1/csv/AAA1B11",
  headers: {
    Authorization: "XPTO",
  },
};
 
axios
  .request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

PHP

<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.activethread.com.br/detran/v1/csv/AAA1B11',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: XPTO'
  ),
));
 
$response = curl_exec($curl);
 
curl_close($curl);
echo $response;

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.activethread.com.br/detran/v1/csv/AAA1B11")
  .header("Authorization", "XPTO")
  .asString();

Python

import requests
 
url = "https://api.activethread.com.br/detran/v1/csv/AAA1B11"
 
payload = {}
headers = {
  'Authorization': 'XPTO'
}
 
response = requests.request("GET", url, headers=headers, data=payload)
 
print(response.text)