Skip to content
Navo24Navo24
Comece grátis

Primeiros passos

Primeiros passos

Guia rápido da API de rastreamento de contêineres: sua primeira chamada à Navo24 em 2 minutos sem chave, depois uma chave de API e um embarque rastreado.

A Navo24 é inteligência de frete que você chama diretamente: rastreamento de contêineres e de conhecimentos aéreos (AWB), programações de navios e confiabilidade, tarifas spot e planejamento de carga. Cada produto oferece uma API REST, e a maioria também oferece um servidor MCP, tudo com uma única chave bearer.

Faça uma chamada sem conta

A forma mais rápida de ver dados reais é o endpoint público da API de rastreamento de contêineres. Ele não exige chave.

curl -X POST https://api.trackingmcp.com/v1/track/public \
  -H "Content-Type: application/json" \
  -d '{"reference":"MEDU1234562"}'

Você recebe um status normalizado, o navio, os marcos e um ETA que indica se ainda é uma previsão:

{
  "ok": true,
  "data": {
    "identifier": "MEDU1234562",
    "identifier_type": "container_id",
    "carrier_code": "MSCU",
    "carrier_name": "MSC",
    "status": "in_transit",
    "eta": "2026-07-03T06:00:00Z",
    "eta_is_estimated": true,
    "origin": "Ningbo",
    "destination": "Rotterdam",
    "vessel": { "name": "MSC TERESA", "lat": null, "lng": null },
    "events": [
      {
        "description": "Loaded on vessel",
        "location": "Ningbo",
        "event_code": "LOAD",
        "unlocode": "CNNGB",
        "datetime": "2026-06-18T22:10:00Z",
        "actual": true
      }
    ]
  }
}

Quatro campos concentram a maior parte do significado:

  • identifier_type é o que concluímos que a referência realmente é, o que pode ser diferente do seu palpite.
  • eta_is_estimated é true enquanto o ETA é uma previsão, false quando passa a ser a chegada real e null quando não temos nenhum ETA. Uma data sozinha não é uma promessa.
  • actual em um evento é true para algo que aconteceu e false para algo planejado. Nunca trate um movimento planejado como fato.
  • carrier_code, origin, destination e unlocode são null quando o armador não informou nada que conseguimos resolver, em vez de serem adivinhados.

Os endpoints públicos têm limite de requisições por IP e servem para uma verificação rápida. Qualquer uso em escala de portfólio exige uma chave.

Obtenha uma chave de API

  1. Cadastre-se em trackingmcp.com.
  2. Abra as configurações de desenvolvedor e gere uma chave. Ela tem um prefixo de produto, por exemplo tmcp_ para rastreamento.
  3. Envie-a como token bearer em toda requisição autenticada.
curl https://api.trackingmcp.com/v1/containers/summary \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
{
  "ok": true,
  "data": {
    "total_active": 128,
    "exceptions": 6,
    "arriving_this_week": 14,
    "demurrage_risk_usd": 4820.5,
    "containers": []
  }
}

Comece a rastrear um embarque

A superfície com chave recebe dois campos obrigatórios, identifier e identifier_type. O tipo é um destes: container_id, bill_of_lading ou booking.

curl -X POST https://api.trackingmcp.com/v1/containers \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"MEDU1234562","identifier_type":"container_id"}'
{
  "ok": true,
  "data": {
    "id": "8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef",
    "identifier": "MEDU1234562",
    "status": "in_transit",
    "carrier_code": "MSCU",
    "source": "direct_carrier"
  }
}

Guarde o id. Ele é um UUID, e todos os outros endpoints de contêiner usam esse valor como chave, e não o número do contêiner. Um contêiner que aceitamos, mas não conseguimos resolver na primeira tentativa, retorna com "status": "unknown" e um warning, e é preenchido em poucos minutos conforme a nova consulta é executada.

A mesma chave funciona em toda a família de produtos quando o produto aceita a credencial da família. Leia o guia de autenticação para ver o quadro completo sobre prefixos e cabeçalhos.

Próximos passos