Saltar al contenido principal

Partner Portal APIs

Portal endpoints for authenticated partner users.

Base URL​

https://service-gateway.loscenotes.com/api/partner-portal

Authentication​

Authorization: Bearer <jwt>

Endpoint groups​

Dashboard​

  • GET /api/partner-portal/dashboard
  • GET /api/partner-portal/metrics
  • GET /api/partner-portal/activity-feed

API key management​

  • GET /api/partner-portal/api-keys — returns masked key + keyPrefix + lastUsedAt (no full secret)
  • POST /api/partner-portal/api-keys — once-reveal full key on create
  • PUT /api/partner-portal/api-keys/:keyId
  • DELETE /api/partner-portal/api-keys/:keyId
  • POST /api/partner-portal/api-keys/:keyId/rotate — once-reveal on rotate

Webhooks​

  • GET /api/partner-portal/webhooks
  • POST /api/partner-portal/webhooks
  • PUT /api/partner-portal/webhooks/:webhookId
  • DELETE /api/partner-portal/webhooks/:webhookId
  • POST /api/partner-portal/webhooks/:webhookId/test
  • GET /api/partner-portal/webhooks/:webhookId/logs

Onboarding​

  • POST /api/partner-portal/onboarding/start
  • GET /api/partner-portal/onboarding/status
  • POST /api/partner-portal/onboarding/complete-step/:step

Portal sandbox​

  • GET /api/partner-portal/sandbox/status
  • POST /api/partner-portal/sandbox/reset
  • POST /api/partner-portal/sandbox/generate-data

Live cuando existe el schema partners_sandbox: generate/reset/status ejecutan operaciones reales de sandbox. Soft-fail (payload de éxito explicando indisponibilidad) solo si el schema falta en ese entorno. Las claves sk_test_ emitidas son solo para tooling de sandbox — no pueden llamar rutas de producción /api/partner/*.

Billing and usage​

Billing P2 (parcial): los conteos de API pueden ser reales; bandwidth, métricas de webhooks, catálogo de plan y settlements-as-invoices están incompletos. La UI de billing del portal sigue en cuarentena — no es un producto comercial completo aún.

  • GET /api/partner-portal/billing/usage
  • GET /api/partner-portal/billing/invoices
  • GET /api/partner-portal/billing/plan

Support​

  • POST /api/partner-portal/support/ticket
  • GET /api/partner-portal/support/tickets
  • GET /api/partner-portal/quickstart

Support ticket creation/listing is currently not implemented at storage level; runtime returns acknowledgment / empty-list style responses.

Notes​

  • these endpoints are operational/portal-focused, not public partner API key endpoints
  • data isolation is enforced through the authenticated partner context
  • for organization-level config, users, reports, reservations and sandbox tooling, see Management features