---
title: Quais os possíveis códigos de erro da Tracking API?
description: Conheça os status codes para cada endpoint e os possíveis erros que podem ser retornados pela Tracking API.
---

[Pular para o conteúdo](https://knowledge.maplink.global/migration/pt-br/base/quais-os-possíveis-códigos-de-erro-da-freight-api-1#main-content)

Português - Brasil

Mostrar submenu para traduções

[Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new?hsLang=pt-br) [Portal do cliente](https://knowledge.maplink.global/customers?hsLang=pt-br)

![logo\_maplink-1.png\]](https://knowledge.maplink.global/hs-fs/hubfs/logo_maplink-1.png?height=40&name=logo_maplink-1.png)

Abrir navegação principal

Fechar navegação principal

- Português - Brasil
  
  Mostrar submenu para traduções
- [Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new)
- [Portal do cliente](https://knowledge.maplink.global/customers)
- Ir para maplink.global

 Ir para maplink.global

 Olá. Como podemos ajudá-lo?

- Não há sugestões porque o campo de pesquisa está em branco.

1. [Centro de ajuda](https://knowledge.maplink.global/migration/pt-br/base?hsLang=pt-br)
2. [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br)
3. [Tracking API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#tracking-api)

# Quais os possíveis códigos de erro da Tracking API?

## Conheça os status codes para cada endpoint e os possíveis erros que podem ser retornados pela Tracking API.

Abaixo a tabela com os *status codes* para cada endpoint disponível na Tracking API:

| **Código** | **Método** | **Endpoint** | **Descrição** |
| --- | --- | --- | --- |
| 200 | POST | [https://api.maplink.global/tracking/v1/orders](https://api.maplink.global/tracking/v1/orders) | OK (link gerado com sucesso) |
| 400 | POST | [https://api.maplink.global/tracking/v1/orders](https://api.maplink.global/tracking/v1/orders) | Error: Bad Request (falta de parâmetros, envio incompleto ou requisição com erros) |
| 500 | POST | [https://api.maplink.global/tracking/v1/orders](https://api.maplink.global/tracking/v1/orders) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | GET | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | OK |
| 404 | GET | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | GET | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | DELETE | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | OK (pedido excluído com sucesso) |
| 404 | DELETE | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | DELETE | [https://api.maplink.global/tracking/v1/orders/](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 204 | POST | [https://api.maplink.global/tracking/v1/orders//status](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/status) | OK (status atualizado com sucesso) |
| 404 | DELETE | [https://api.maplink.global/tracking/v1/orders//status](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/status) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | DELETE | [https://api.maplink.global/tracking/v1/orders//status](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/status) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 204 | POST | [https://api.maplink.global/tracking/v1/orders//driver](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/driver) | OK (localização do motorista atualizada com sucesso) |
| 404 | DELETE | [https://api.maplink.global/tracking/v1/orders//driver](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/driver) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | DELETE | [https://api.maplink.global/tracking/v1/orders//driver](https://api.maplink.global/tracking/v1/orders/%7B%7BtrackingId%7D%7D/driver) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | POST | [https://api.maplink.global/tracking/v1/themes](https://api.maplink.global/tracking/v1/themes) | OK (tema criado com sucesso) |
| 400 | POST | [https://api.maplink.global/tracking/v1/themes](https://api.maplink.global/tracking/v1/themes) | Error: Bad Request (falta de parâmetros, envio incompleto ou requisição com erros) |
| 500 | POST | [https://api.maplink.global/tracking/v1/themes](https://api.maplink.global/tracking/v1/themes) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | GET | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | OK |
| 404 | GET | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | GET | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | PUT | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | OK (tema atualizado com sucesso) |
| 404 | PUT | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | PUT | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | An Internal Server Error occurred (erro interno no processamento da requisição) |
| 200 | DELETE | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | OK (tema excluído com sucesso) |
| 404 | DELETE | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | NOT FOUND (não encontrado por ID incorreto) |
| 500 | DELETE | [https://api.maplink.global/tracking/v1/themes/](https://api.maplink.global/tracking/v1/themes/%7B%7BtrackingTheme%7D%7D) | An Internal Server Error occurred (erro interno no processamento da requisição) |

A tabela a seguir mostra todas as mensagens de erro que podem ser retornadas pela API no *body* da resposta:

| **Código de erro** | **Mensagem** | **Descrição** |
| --- | --- | --- |
| Validation failed | at origin and destionation, mainLocation lat and lon cannot be null | Os parâmetros "lat" e "lon" na origem e destino não podem ser nulos. |
| validation fail | to fill the params of the object ‘driver’, the status must be set as ‘ON\_THE\_WAY | Para atualizar as coordenadas do motorista é necessário que o status do pedido seja ON\_THE\_WAY. |
| validation fail | color must be a valid hexadecimal value, like #000000" | O parâmetro color só aceita valores hexadecimais, como por exemplo #000 ou #000000. |

 

- [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#main-content)

    - [Planning API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#planning-api)
    - [Trip API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#trip-api)
    - [Toll API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-api)
    - [Toll for Maps API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-for-maps-api)
    - [Distance Matrix API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#distance-matrix-api)
    - [CO2 API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#co2-api)
    - [Restriction Zone API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#restriction-zone-api)
    - [Geocode API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#geocode-api)
    - [Freight API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#freight-api)
    - [Tracking API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#tracking-api)
- [APIs Google Maps Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-google-maps-platform?hsLang=pt-br)
- [Webinar e Workshop](https://knowledge.maplink.global/migration/pt-br/base/webinar-e-workshop?hsLang=pt-br)

[![](https://knowledge.maplink.global/hs-fs/hubfs/logo-maplink-novo-horizontal-colorido%20PNG.png?width=2190&height=540&name=logo-maplink-novo-horizontal-colorido%20PNG.png)](http://maplink.global)

Centro de ajuda maplink.global

Copyright © 2026, Maplink Cloud