Meaple SDK
SDK oficial para integração com a plataforma Meaple — gestão de eventos e vendas de ingressos.
Fluxo de uso
O SDK segue um fluxo simples:
- Criar a instância — instalar pacotes e configurar
MeapleSDKcom o ID do canal - Autenticar o consumidor — apenas quando for usar recursos que exigem login (OAuth2)
- Consumir as APIs — eventos, categorias, ingressos, pedidos, etc.
Pacotes
Os pacotes do Meaple SDK se complementam: o core concentra as chamadas HTTP para a API, enquanto os demais oferecem ergonomia para React e composição de UI.
| Pacote | Descrição |
|---|---|
| @meaple-com/core | SDK principal: instância, recursos e chamadas HTTP |
| @meaple-com/types | Tipos (DTOs) compartilhados entre Core, React Query e Headless Components |
| @meaple-com/react-query | Hooks React Query para eventos, pedidos, ingressos, etc. |
| @meaple-com/react-headless-components | Componentes headless (render props) para listas, carrinho, ingressos |
Documentação
- Guia rápido — Instalação, instância, autenticação e primeira chamada
- Construindo uma Ticketeira Completa — Fluxo end-to-end: listagem, carrinho, cupom, checkout e pedido
- Core SDK — Recursos, parâmetros e conceitos (tipos, paginação)
- Autenticação — OAuth2 com PKCE, better-auth e boas práticas
- Tratamento de erros — Erros HTTP (Axios) e uso com React Query
- React Query — Hooks disponíveis
- Headless Components — Componentes headless
Começar Agora
Links
Last updated on