Tratamento de erros

Como tratar erros ao usar o Meaple SDK (Core). As requisições podem falhar por rede ou quando o servidor retorna códigos 4xx/5xx.

Formato das respostas de erro

Todos os erros retornados pelo servidor possuem o campo message no corpo da resposta (além do código de status HTTP), com uma descrição legível do problema.

Exemplo de resposta de erro:


{
  "message": "Evento já ocorreu, não é possível reembolsar"
}

💡 Dica: O cliente recebe o status HTTP (ex.: 400, 404, 422) e pode ler message para exibir ao usuário.

Tratamento básico (Core)


import { MeapleSDK } from '@meaple-com/core';
 
const sdk = new MeapleSDK({
  publicKey: 'pk_seu_channel_id',
});
 
try {
  const events = await sdk.events.find();
} catch (error: any) {
  const status = error?.response?.status;
  const message =
    error?.response?.data?.message ?? error?.message ?? 'Erro desconhecido';
  console.error('Status:', status);
  console.error('Mensagem:', message);
}

Códigos de status comuns

Status	Tipo	Significado
`400`	❌ Client	Bad Request — dados inválidos ou erro de validação
`401`	🔒 Auth	Unauthorized — token inválido ou ausente
`403`	🔒 Auth	Forbidden — sem permissão para o recurso
`404`	❌ Client	Not Found — recurso não encontrado
`422`	❌ Client	Unprocessable Entity — erro de regra de negócio (ex.: evento já ocorreu)
`429`	⚠️ Rate	Too Many Requests — limite de requisições
`500`	🔧 Server	Internal Server Error — erro no servidor

Ver também

Core SDK — visão geral do SDK
Paginação — cursor e limites