API para consulta de encomendas 📦

Há um tempo atrás, a comunidade do TabNews compartilhou a API que os correios tinham disponibilizado para obter informações sobre rastreio de encomendas, mas pouco tempo depois eles a descontinuaram.

Um tempo depois, consegui colocar essa função de consulta novamente na API que desenvolvo. Minha meta com ela é servir todos os dados do Brasil que eu puder para que mais projetos e serviços legais possam ser criados pela comunidade. Se quiser dar uma olhada, você pode acessar a documentação dela aqui.

// GET https://brasilaberto.com/api/v1/postal-orders/QE*********BR

{
  "meta": {
    "currentPage": 1,
    "itemsPerPage": 1,
    "totalOfItems": 1,
    "totalOfPages": 1
  },
  "result": {
    "code": "QE*********BR",
    "from": "Brasil",
    "status": "Distribuído ao remetente.",
    "historyItems": [
      {
        "title": "Objeto postado após o horário limite da unidade",
        "detail": "Agência dos Correios - XPTO",
        "utcDate": "2021-03-16T23:12:00.000Z"
      },
      {
        "title": "Em trânsito para Unidade de Tratamento - XPTO/123",
        "detail": "Agência dos Correios - XPTO/123 Objeto encaminhado",
        "utcDate": "2021-03-17T08:56:00.000Z"
      },
      {
        "title": "Solicitação de suspensão de entrega recebida",
        "detail": "Unidade de treinamento / teste",
        "utcDate": "2021-04-27T17:52:00.000Z"
      },
      {
        "title": "Objeto será devolvido por solicitação do contratante/remetente",
        "detail": "Unidade de Distribuição - XPTO/123",
        "utcDate": "2021-05-04T14:53:00.000Z"
      },
      {
        "title": "Em trânsito para Unidade de Tratamento - XPTO/123",
        "detail": "Unidade de Distribuição - XPTO/123 Objeto encaminhado",
        "utcDate": "2021-05-05T12:44:00.000Z"
      },
      {
        "title": "Em trânsito para Unidade de Tratamento - BELO HORIZONTE/MG",
        "detail": "Unidade de Tratamento - RIO DE JANEIRO/RJ Objeto encaminhado",
        "utcDate": "2021-05-12T22:08:00.000Z"
      },
      {
        "title": "Em trânsito para Unidade de Distribuição - XPTO/123",
        "detail": "Unidade de Tratamento - BELO XPTO/123 Objeto encaminhado",
        "utcDate": "2021-05-16T12:23:00.000Z"
      },
      {
        "title": "Em trânsito para Unidade de Distribuição - XPTO/123",
        "detail": "Unidade de Tratamento - XPTO/123 Objeto encaminhado",
        "utcDate": "2021-05-16T12:23:00.000Z"
      },
      {
        "title": "Objeto saiu para entrega ao remetente",
        "detail": "Unidade de Distribuição - XPTO/123",
        "utcDate": "2021-05-19T13:06:00.000Z"
      },
      {
        "title": "Distribuído ao remetente.",
        "detail": "Unidade de Distribuição - XPTO/123",
        "utcDate": "2021-05-19T15:24:00.000Z"
      }
    ]
  }
}

Stack do projeto

Nesse projeto eu uso NextJs, muito influenciado pelos vídeos do Filipe e tudo que ele já criou usando esse framework. Eu também uso o banco de dados da Planet Scale. O bacana deles é que eles usam um sistema serverless distribuído para servir os bancos, além de ter opções de servidores no Brasil. Além disso, eu tenho usado o Axiom para acompanhar alguns logs das aplicações na vercel, outra indicação do Deschamps que tem me ajudado bastante 😄.