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)