Referência da API

Referência da API

Referência completa da API para todos os pacotes do SDK.

Instalação

Instale os pacotes que você precisa:

yarn add @meaple/core

Para aplicações React com React Query:

yarn add @meaple/react-query @tanstack/react-query

Para componentes de UI headless:

yarn add @meaple/react-headless-components

Configuração Básica

Core SDK

import { MeapleSDK } from '@meaple/core';
 
const sdk = new MeapleSDK({
  publicKey: process.env.MEAPLE_PUBLIC_KEY,
  baseURL: 'https://api.meaple.com',
});
 
const events = await sdk.events.find();

Com React Query

import { useEvents } from '@meaple/react-query'
 
function EventsList() {
  const { data: events, isLoading } = useEvents()
 
  if (isLoading) return <div>Carregando...</div>
 
  return (
    <ul>
      {events?.map(event => (
        <li key={event.id}>{event.name}</li>
      ))}
    </ul>
  )
}

Com Headless Components

import { ListEvents } from '@meaple/react-headless-components'
 
function EventsPage() {
  return (
    <ListEvents>
      {({ events, isLoading }) => (
        <div>
          {isLoading ? <p>Carregando...</p> : (
            <ul>
              {events.map(event => (
                <li key={event.id}>{event.name}</li>
              ))}
            </ul>
          )}
        </div>
      )}
    </ListEvents>
  )
}

Autenticação

Configure a autenticação usando tokens globais:

import { MeapleSDK, setGlobalToken } from '@meaple/core';
 
const sdk = new MeapleSDK({
  publicKey: 'pk_meaple_0001',
  baseURL: 'https://api.meaple.com',
});
 
// Fazer login
const { accessToken, refreshToken } = await sdk.auth.authenticate({
  email: 'user@example.com',
  password: 'password123',
});
 
// Configurar token global
setGlobalToken(accessToken, refreshToken, async refreshToken => {
  const response = await sdk.auth.refreshToken(refreshToken);
  return {
    accessToken: response.accessToken,
    refreshToken: response.refreshToken,
  };
});

Variáveis de Ambiente

Crie um arquivo .env.local:

MEAPLE_PUBLIC_KEY=pk_meaple_0001
MEAPLE_BASE_URL=https://api.meaple.com

Próximos Passos

Ingressos