OpenAPI 3.0.3

Consulta de chapas DINATRAN

API HTTP para consultar placas nacionais paraguaias no serviço público da DINATRAN (mostrarplacanacional). Não há persistência em disco ou banco: apenas cache e rate limit em memória.

v1.0.0/api/openapi.json

Autenticação

A API pública exige Bearer token. A página inicial usa uma server action interna e não envia token ao navegador.

Defina API_TOKENS com uma lista separada por vírgulas. Cada item pode ser só o token ou nome:token.

curl -sS \
  -H "Authorization: Bearer SEU_TOKEN" \
  http://localhost:3000/api/placa/AAHH728

Endpoints

Método	Caminho	Descrição
GET	/api/placa/{placa}	Consultar dados de uma placa nacional
GET	/api/openapi.json	Especificação OpenAPI em JSON

Erros

Corpo JSON estável: { "error": { "code", "message", "status" } }

HTTP	code	Quando
400	INVALID_PLATE	Placa com formato inválido
401	UNAUTHORIZED	Bearer token ausente ou inválido
404	NOT_FOUND	Placa não encontrada na DINATRAN
429	RATE_LIMITED	Limite por IP ou token excedido
502	UPSTREAM_ERROR / UNPARSEABLE	Erro ou HTML inválido da DINATRAN
504	TIMEOUT	A DINATRAN não respondeu a tempo

Exemplo de resposta

Baseado na placa AAHH728. Documento e telefone mascarados.

{
  "placa": "AAHH728",
  "fonte": "DINATRAN",
  "consultadoEm": "2026-10-19T17:30:00.000Z",
  "proprietario": {
    "nome": "26518-TRANSPORTADORA ESPECIALIZADA DE CARGAS S.A.",
    "documento": "********-7",
    "cedula": null,
    "ruc": "********-7",
    "endereco": "MADAN LINCH CASI AVIADORES DEL CHACO-ASUNCION",
    "telefone": "0981******"
  },
  "habilitacao": {
    "numero": "2298674",
    "vencimento": "2027-08-10",
    "situacao": "VIGENTE",
    "estado": null
  },
  "veiculo": {
    "ano": 2018,
    "marca": "IVECO",
    "tipo": "CAMION FURGON",
    "chassi": "93ZE12JMZK8934465",
    "servico": "CARGA NACIONAL",
    "eixos": 3,
    "pesoKg": 24000,
    "codigoSeguranca": "0",
    "jornais": 0
  },
  "chapaProvisoria": null,
  "dataBaixa": null,
  "observacoes": "Orden de Insp. Nº: 0",
  "multas": [],
  "inspecoes": [
    {
      "ano": 2021,
      "codigoTaller": "CITV1107",
      "taller": "CITV IVESUR S.A. ASUNCION",
      "dataInspecao": "2021-08-10",
      "planilha": "16566",
      "certificado": "933075",
      "vencimento": "2022-08-10",
      "resultado": "APROBADA",
      "classe": "Permisionaria"
    }
  ]
}

Carregando documentação…

Método

Caminho

Descrição

GET

/api/placa/{placa}

Consultar dados de uma placa nacional

GET

/api/openapi.json

Especificação OpenAPI em JSON

HTTP

code

Quando

400

INVALID_PLATE

Placa com formato inválido

401

UNAUTHORIZED

Bearer token ausente ou inválido

404

NOT_FOUND

Placa não encontrada na DINATRAN

429

RATE_LIMITED

Limite por IP ou token excedido

502

UPSTREAM_ERROR / UNPARSEABLE

Erro ou HTML inválido da DINATRAN

504

TIMEOUT

A DINATRAN não respondeu a tempo

{ "placa": "AAHH728", "fonte": "DINATRAN", "consultadoEm": "2026-10-19T17:30:00.000Z", "proprietario": { "nome": "26518-TRANSPORTADORA ESPECIALIZADA DE CARGAS S.A.", "documento": "********-7", "cedula": null, "ruc": "********-7", "endereco": "MADAN LINCH CASI AVIADORES DEL CHACO-ASUNCION", "telefone": "0981******" }, "habilitacao": { "numero": "2298674", "vencimento": "2027-08-10", "situacao": "VIGENTE", "estado": null }, "veiculo": { "ano": 2018, "marca": "IVECO", "tipo": "CAMION FURGON", "chassi": "93ZE12JMZK8934465", "servico": "CARGA NACIONAL", "eixos": 3, "pesoKg": 24000, "codigoSeguranca": "0", "jornais": 0 }, "chapaProvisoria": null, "dataBaixa": null, "observacoes": "Orden de Insp. Nº: 0", "multas": [], "inspecoes": [ { "ano": 2021, "codigoTaller": "CITV1107", "taller": "CITV IVESUR S.A. ASUNCION", "dataInspecao": "2021-08-10", "planilha": "16566", "certificado": "933075", "vencimento": "2022-08-10", "resultado": "APROBADA", "classe": "Permisionaria" } ] }