Documentación de la API Mokapen

Organizaciones

La mayoría de los endpoints de Mokapen están scoped a una sola organización. El contexto de la organización queda definido tanto en la URL como en el token de acceso.

Organization ID en la URL

Los endpoints de las entidades siguen este patrón:

GET /api/v1/{org_id}/contacts
GET /api/v1/{org_id}/tasks
POST /api/v1/{org_id}/store_contact
Sustituye {org_id} por el ID numérico de la organización. Algunas integraciones pueden usar un identificador de organización cifrado; la API acepta ambos formatos donde esté soportado.

Vínculo de la organización en el token

Los tokens emitidos para aplicaciones developer incluyen un organization_id (guardado en el registro del token y presente en la respuesta OAuth).

Cuando llamas un endpoint con {org_id} en la URL, Mokapen verifica que el token esté autorizado para esa organización. Si la organización en la URL no coincide con la del token, la API responde 403 Forbidden.

  • App private — la organización se define automáticamente al generar el token (según la organización activa en el dashboard Developer).
  • App public — el usuario final selecciona la organización durante el consentimiento OAuth.

Endpoint de listado de organizaciones

Para obtener las organizaciones accesibles al usuario o a la integración autenticada:

GET /api/v1/organizations

Premium de la organización y acceso a la API

La disponibilidad de la API y las cuotas diarias dependen del plan Mokapen de la organización. Consulta Límites de la API para los límites por plan.

Empieza a trabajar ahorrando tiempo.

o
Agendar una demo

¿Necesitas ayuda?