O Base39 usa códigos de resposta HTTP padrão para indicar sucesso ou falha de uma solicitação de API. No geral as repostas do intervalo 2xx indicam sucesso. O status 4xx indica um erro que falhou de acordo com as informações fornecidas. O status 5xx vão indicar um erro inesperado. Seguem abaixo os códigos utilizados em nossas APIs:

CódigoStatusInterpretação
200OKSucesso
201CreatedRecurso criado
400Bad RequestRequisição inválida, recurso obrigatório enviado incorretamente e/ou não enviado
401UnauthorizedFalha de autenticação
403ForbiddenSua aplicação não está autorizada a acessar esse ambiente
404Not FoundRequisição válida e processada, item pesquisado não encontrado
500Internal Server ErrorOcorreu um erro interno

Exemplos

200

Exemplo de retorno de um endpoint de listagem.

{
    "data": [
        { ...
        },
        ...
    ],
    "hasMore": true
}

201

Exemplo de retorno de um endpoint de criação.

{
  "id": "comp_5f92f01728e009f403d8502e",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "deleted": true,
	...
}

400

Exemplo de erro quando o corpo da requisição é invalido.

{
    "code": "INVALID_BODY",
    "message": "The document field must have a valid CPF."
}

401

Exemplo de retorno de uma solicitação não autorizada.

{
    "message": "Unauthorized"
}

403

Exemplo de retorno de uma solicitação proibida.

{
    "message": "Missing Authentication Token"
}

404

Exemplo de retorno de uma solicitação de recurso não existente.

{
    "code": "INVOICE_NOT_FOUND",
    "message": "Customer not found."
}

500

Exemplo de erro não esperado.

{
    "code": "UNEXPECTED_ERROR",
    "message": "We're sorry! An unexpected error has occurred."
}