Primeiros Passos

Tratamento de Erros

A API Fintely utiliza códigos de status HTTP padrão para indicar o resultado de cada requisição.

Códigos de Status

Código	Significado
`200`	Requisição bem-sucedida
`201`	Recurso criado com sucesso
`400`	Requisição inválida — verifique os parâmetros enviados
`401`	Não autorizado — API Key ausente ou inválida
`403`	Acesso negado — sem permissão para o recurso
`404`	Recurso não encontrado
`422`	Erro de validação — campos obrigatórios ausentes ou valores inválidos
`500`	Erro interno do servidor

Respostas de erro seguem o formato:


Code
 
{
  "error": "Descrição do erro",
  "details": [
    {
      "field": "nome_do_campo",
      "message": "Mensagem de validação"
    }
  ]
}

Sempre verifique o código de status HTTP da resposta antes de processar o corpo.
Implemente tratamento de erros adequado para cada código de status.
Em caso de erro 500, aguarde alguns segundos e tente novamente. Se o problema persistir, entre em contato com o suporte.

Last modified on March 24, 2026

Primeiros Passos

A API Fintely utiliza códigos de status HTTP padrão para indicar o resultado de cada requisição.

Código	Significado
`200`	Requisição bem-sucedida
`201`	Recurso criado com sucesso
`400`	Requisição inválida — verifique os parâmetros enviados
`401`	Não autorizado — API Key ausente ou inválida
`403`	Acesso negado — sem permissão para o recurso
`404`	Recurso não encontrado
`422`	Erro de validação — campos obrigatórios ausentes ou valores inválidos
`500`	Erro interno do servidor

Respostas de erro seguem o formato:


Code
 
{
  "error": "Descrição do erro",
  "details": [
    {
      "field": "nome_do_campo",
      "message": "Mensagem de validação"
    }
  ]
}

Sempre verifique o código de status HTTP da resposta antes de processar o corpo.
Implemente tratamento de erros adequado para cada código de status.
Em caso de erro 500, aguarde alguns segundos e tente novamente. Se o problema persistir, entre em contato com o suporte.

Last modified on March 24, 2026