Respostas
Códigos HTTP previsíveis
Erros retornam JSON com a propriedade
error. Não dependa apenas do texto: use o status HTTP para decidir a ação do conector.200SucessoConsulta ou atualização concluída.201CriadoO recurso foi cadastrado corretamente.400Requisição inválidaCampos ausentes, formato ou status inválido.401Não autorizadoChave ausente, inválida ou revogada.403Sem permissãoA chave não possui o escopo exigido.404Não encontradoO recurso não existe para a empresa autenticada.409ConflitoA operação viola o estado ou o histórico do recurso.429Limite excedidoA chave ultrapassou 120 requisições por minuto.500Erro internoFalha inesperada processada pela SoftBuy.