A API da Trio utiliza a convenção HTTP para indicar o sucesso ou a falha em uma requisição. Requisições com feitas com sucesso são retornadas no intervalo 2xx, requisições com falhas devido a informações fornecidas (ex: falha de autenticação) são retornadas no intervalo 4xx e erros nos servidores da Trio são retornados no intervalo 5xx.

Resumo dos códigos HTTP

Código

Tipo

Descrição

200

Success

Tudo funcionou como esperado.

201

Success

Recurso criado com sucesso.

204

Success

Tudo funcionou como esperado, mas sem conteúdo no body.

400

Bad request

Falha na requisição devido a erro ou falta da informação.

401

Unauthorized

Credenciais de autenticação inválida.

404

Not Found

O recurso solicitado não foi encontrado.

429

Too Many Requests

Muitas requisições a API de maneira simultânea.

500

Server Error

Algo aconteceu de erro na infraestrutura da Trio.

Schema

Para facilitar a identificação e tratamento dos erros a API da Trio fornece uma estrutura padronizada para retornar as mensagens:

  • errors- contém uma lista com a mais detalhes e informações sobre os erros.

A resposta sempre é retornada no format JSON:

{
  "errors": "Invalid client_secret"
}