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

OK (link gerado com sucesso)

400

POST

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

An Internal Server Error occurred (erro interno no processamento da requisição)

200

GET

https://api.maplink.global/tracking/v1/orders/

OK

404

GET

https://api.maplink.global/tracking/v1/orders/

NOT FOUND (não encontrado por ID incorreto)

500

GET

https://api.maplink.global/tracking/v1/orders/

An Internal Server Error occurred (erro interno no processamento da requisição)

200

DELETE

https://api.maplink.global/tracking/v1/orders/

OK (pedido excluído com sucesso)

404

DELETE

https://api.maplink.global/tracking/v1/orders/

NOT FOUND (não encontrado por ID incorreto)

500

DELETE

https://api.maplink.global/tracking/v1/orders/

An Internal Server Error occurred (erro interno no processamento da requisição)

204

POST

https://api.maplink.global/tracking/v1/orders//status

OK (status atualizado com sucesso)

404

DELETE

https://api.maplink.global/tracking/v1/orders//status

NOT FOUND (não encontrado por ID incorreto)

500

DELETE

https://api.maplink.global/tracking/v1/orders//status

An Internal Server Error occurred (erro interno no processamento da requisição)

204

POST

https://api.maplink.global/tracking/v1/orders//driver

OK (localização do motorista atualizada com sucesso)

404

DELETE

https://api.maplink.global/tracking/v1/orders//driver

NOT FOUND (não encontrado por ID incorreto)

500

DELETE

https://api.maplink.global/tracking/v1/orders//driver

An Internal Server Error occurred (erro interno no processamento da requisição)

200

POST

https://api.maplink.global/tracking/v1/themes

OK (tema criado com sucesso)

400

POST

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

An Internal Server Error occurred (erro interno no processamento da requisição)

200

GET

https://api.maplink.global/tracking/v1/themes/

OK

404

GET

https://api.maplink.global/tracking/v1/themes/

NOT FOUND (não encontrado por ID incorreto)

500

GET

https://api.maplink.global/tracking/v1/themes/

An Internal Server Error occurred (erro interno no processamento da requisição)

200

PUT

https://api.maplink.global/tracking/v1/themes/

OK (tema atualizado com sucesso)

404

PUT

https://api.maplink.global/tracking/v1/themes/

NOT FOUND (não encontrado por ID incorreto)

500

PUT

https://api.maplink.global/tracking/v1/themes/

An Internal Server Error occurred (erro interno no processamento da requisição)

200

DELETE

https://api.maplink.global/tracking/v1/themes/

OK (tema excluído com sucesso)

404

DELETE

https://api.maplink.global/tracking/v1/themes/

NOT FOUND (não encontrado por ID incorreto)

500

DELETE

https://api.maplink.global/tracking/v1/themes/

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.