## DETRAN / DF / Veículo (Mobile)
Consulta cadastro do veículo no Departamento Estadual de Trânsito (DETRAN) do Distrito Federal (DF) através de aplicativo de celular.Se você deseja utilizar uma única API para consultar restrições de veículos em DETRANs de todos os estados do Brasil, recomendamos utilizar a API Detran / Restrições (Unificada).


### URL do site
- https://play.google.com/store/apps/details?id=br.com.mesotec.detrandf&hl=pt_BR&gl=US&pli=1

### Requisição
URL para POST: `https://api.infosimples.com/api/v2/consultas/detran/df/veiculo/mobile`



| Parâmetro | Descrição                                                                                                |
| --------- | -------------------------------------------------------------------------------------------------------- |
| token*    | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. |
| placa*    | Placa do veículo a ser consultado.                                                                       |
| renavam*  | RENAVAM do veículo a ser consultado.                                                                     |

> * Parâmetro obrigatório.

> ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente.


### Exemplos de respostas (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "product": "Consultas",
    "service": "detran/df/veiculo/mobile",
    "parameters": {
      "placa": "AAA1111",
      "renavam": "1111111111"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.2",
    "requested_at": "2022-11-22T09:20:31.000-03:00",
    "elapsed_time_in_milliseconds": 164,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX1+KbiUWhlj9IiSKQeZdT1Qer0oZlxXOEI4FRfHTXJYZ0LCdNI1lFAF3qxvIAQbY2UBm7xt5Nbf6MA=="
  },
  "data_count": 1,
  "data": [
    {
      "ano": "2005",
      "ano_fabricacao": "2004",
      "ano_modelo": "2005",
      "capacidade_passageiros": null,
      "categoria": "PARTICULAR",
      "chassi": "1AA11111AA1111111",
      "combustivel": null,
      "cor": null,
      "debitos": {
        "licenciamentos": [
          {
            "ano": "2022",
            "vencimento": "23/02/2022",
            "valor": "87.66",
            "multa": "9.2",
            "mora": "9.11",
            "outros": "",
            "pago": "0.0",
            "total": "110.33"
          }
        ],
        "ipva": [],
        "dpvat": [],
        "detran": []
      },
      "especie": "Exemplo de espécie",
      "gravame": {
        "situacao": "VEÍCULO TEVE GRAVAME BAIXADO PELO AGENTE FINANCEIRO",
        "numero_restricao": "11111111",
        "numero_contrato": "1111111",
        "uf": "SP",
        "datahora": "14/11/2012 13:33:46",
        "financiado_documento": "12.345.678/9012-34",
        "financiado_nome": "Exemplo de nome",
        "agente_nome": "Exemplo de nome",
        "agente_codigo": "1111",
        "agente_documento": "12.345.678/9012-34"
      },
      "infracoes": [
        {
          "ait": "A123456789",
          "status": "Multa DF c/veiculo DF Notificada",
          "codigo_renainf": "",
          "orgao_autuador": "DETRAN - DF",
          "codigo_orgao_autuador": "123456",
          "regulamento": "",
          "descricao": "Exemplo de descrição",
          "velocidade_permitida": 0,
          "velocidade_aferida": 0,
          "local": "Avenida Paulista, 807",
          "data": "11/11/2011",
          "hora": "13:48",
          "responsavel": "Nome de Exemplo",
          "natureza": "Exemplo de Natureza",
          "pontos": 5,
          "data_notificacao": "10/03/2016",
          "data_penalidade": "26/02/2016",
          "data_limite_defesa": "01/01/2000",
          "vencimento": "19/08/2016",
          "valor": "191.54",
          "valor_com_desconto": "153.23",
          "valor_com_correcao": "191.54"
        }
      ],
      "marca": "FIAT",
      "modelo": "PALIO WEEK ELX FLEX",
      "municipio": "SAO PAULO / SP",
      "nacionalidade": null,
      "placa": "AAA1111",
      "potencia_cilindradas": "",
      "renavam": "1111111111",
      "restricoes": [
        "AL. FID.",
        "C.VENDA"
      ],
      "roubo_furto": "NADA CONSTA",
      "situacao_veiculo": "CIRCULACAO",
      "tipo": "AUTOMOVEL",
      "ultimo_licenciamento": "2015",
      "site_receipt": "https://www.exemplo.com/exemplo-de-url"
    }
  ],
  "site_receipts": []
}
```


### Arquivo de visualização de consulta

O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API **pode ser sintetizado pela Infosimples** usando as informações originais da fonte quando o arquivo emitido pela fonte não for adequado para visualização.

### Exemplos de códigos para integração com a API


#### Python
```python
# Testado com: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/detran/df/veiculo/mobile'
args = {
  "placa":   "VALOR_DO_PARAMETRO_PLACA",
  "renavam": "VALOR_DO_PARAMETRO_RENAVAM",
  "token":   "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO",
  "timeout": "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## Estamos prontos para ajudar
Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.