Integrações de terceiros
Duas portas permitem que sistemas externos conversem com o RSVP:
- API pública (
/api/v1): o terceiro chama o RSVP para ler eventos e respostas e para registrar inscrições. - Webhooks de saída: o RSVP chama o terceiro quando algo muda (resposta, check-in, estado do evento).
Ambas são administradas por quem é admin da organização em /admin/integracoes, e cada credencial pertence a uma única organização.
Esta documentação segue o Diátaxis: cada página tem um só propósito. Escolha pela sua necessidade.
| Para estudar | Para trabalhar | |
|---|---|---|
| Prático | Tutorial: sua primeira integração: siga do zero até receber um webhook assinado | Guias: como fazer: receitas para tarefas específicas |
| Teórico | Explicação: como e por que funciona assim: modelo mental, garantias e limites | Referência: endpoints, campos, cabeçalhos, códigos de erro |
Qual página abrir
- Nunca usei: comece pelo tutorial.
- Preciso verificar a assinatura, rotacionar um token, reativar um webhook: guias.
- Preciso do nome exato de um campo ou de um código de status: referência.
- Quero entender por que o webhook chegou duplicado ou fora de ordem, ou por que o token é da organização: explicação.
Onde está no código
| Peça | Arquivo |
|---|---|
| Rotas da API | routes/api.php |
| Controllers da API | app/Http/Controllers/Api/V1/ |
| Formato dos dados (API e webhook) | app/Http/Resources/EventResource.php, RsvpResource.php |
| Emissão de webhooks | app/Services/Webhooks/ (WebhookEmittingAuditTrail, WebhookDispatcher, WebhookPayloads, WebhookSigner, WebhookUrlGuard) |
| Entrega com retentativas | app/Jobs/DeliverWebhook.php |
| Tokens e endpoints (administração) | app/Services/Webhooks/IntegrationManager.php, app/Http/Controllers/IntegrationController.php |
Página pública /docs |
app/Http/Controllers/DocsController.php, app/Support/Docs/ (DocsCatalog lista as páginas servidas; para publicar uma nova, adicione-a ali) |