Core SDK

O @meaple-com/core é o SDK principal com todas as funcionalidades da API Meaple. É o único pacote que faz as chamadas HTTP aos endpoints; React Query e Headless Components apenas consomem o Core (os hooks chamam sdk.events.find(), sdk.orders.create(), etc.).

💡 Primeiro uso? Veja o Guia rápido para instalação e configuração completa.

🔒 Autenticação

Métodos marcados com o ícone de cadeado exigem que você configure um token de acesso antes de usá-los:


sdk.setGlobalToken('seu_access_token');

📖 Veja o guia completo em Autenticação

Módulos

Cada recurso da API está documentado em uma página própria:

Módulo	Descrição
Events	Listar eventos, evento por slug, ingressos, produtos, ingressos do usuário, lembrete
Orders	Criar e consultar pedidos
Users	Perfil, pedidos, eventos e reembolso do usuário
Categories	Categorias de eventos
Coupon	Verificar cupons de desconto
Payment	Taxa da plataforma (getFee)
Tickets	Arquivo do ingresso, editar e transferir

ℹ️ Tipos de dados (DTOs)
Muitos métodos retornam tipos como EventProps, TicketProps, OrderProps e UserProps.
Para ver todos os campos desses tipos, consulte Types (Modelos de Dados).

Conceitos

Autenticação — OAuth2 com PKCE (página de primeiro nível)
Tratamento de erros — erros HTTP (Axios) e uso com React Query
Paginação — Cursor e limites
Types (Modelos de Dados) — DTOs compartilhados por Core, React Query e Headless Components