API REST Reference

A API do App Mestre foi construída com base em princípios RESTful. Nossos endpoints retornam JSON e utilizam os códigos de resposta padrão do HTTP.

Autenticação

Atualmente, a API pública foca na integração via Webhooks gerados através do seu Painel de Criador. Para autenticar requisições de servidor-para-servidor (S2S), será necessário gerar um App Token no menu Integrações.

Integração via Webhooks (Inbound)

Para matricular alunos automaticamente assim que uma venda for confirmada externa (ex: Hotmart, Kiwify, Asaas), você pode direcionar o Webhook de pagamento aprovado para a URL exclusiva do seu aplicativo.

POST/webhooks/external/:provider

Provedores suportados atualmente: hotmart, kiwify, eduzz, asaas.

Exemplo S2S (Node.js/Axios)

const axios = require('axios');

// Exemplo: Simulando o payload da Kiwify
const payload = {
  customer_email: "aluno@email.com",
  customer_name: "João Silva",
  order_status: "paid",
  product_id: "seu_produto_123"
};

await axios.post(
  'https://appmestre.app/api/webhooks/external/kiwify?appId=SEU_APP_ID', 
  payload,
  {
    headers: { 'Content-Type': 'application/json' }
  }
);

Response de Sucesso

{
  "success": true,
  "message": "Webhook processado via provider: kiwify"
}

Nota de Segurança: Recomendamos o uso de IDs de webhook secretos gerados pelo painel para ofuscar o seu appId real nas URLs expostas.

Alunos & Matrículas

A gestão manual de alunos pode ser feita via painel, ou conectando o seu sistema de checkout aos nossos endpoints de provisionamento descritos acima.