Mokapen API dokumentation

Organisationer

De flesta Mokapen endpoints är scoped till en enda organisation. Organisationskontexten definieras i både URL:en och åtkomsttoken.

Organisations-ID i URL:en

Slutpunkter på entiteter följer detta mönster:

GET /api/v1/{org_id}/contacts
GET /api/v1/{org_id}/tasks
POST /api/v1/{org_id}/store_contact
Ersätt {org_id} med din organisations numeriska ID. Vissa integrationer kan använda en krypterad organisationsidentifierare; API:et accepterar båda formaten där det stöds.

Organisationsbegränsning på token

Tokens som utfärdas för utvecklarapplikationer inkluderar ett organization_id (sparad i tokenposten och finns i OAuth-svaret).

När du anropar en slutpunkt med {org_id} i URL:en, verifierar Mokapen att token är auktoriserad för den organisationen. Om organisationen i URL:en inte matchar organisationen i token, svarar API:et 403 Forbidden.

  • Privata appar — organisationen ställs automatiskt in vid tokengenerering (baserat på den aktiva organisationen i utvecklarinstrumentpanelen).
  • App offentlig — slutanvändare väljer organisation under OAuth-medgivande.

Organisationslistans slutpunkt

Så här gör du för att få organisationer tillgängliga för användaren eller autentiserad integration:

GET /api/v1/organizations

Premiumorganisation och API-åtkomst

API availability and daily quotas depend on the organization's Mokapen subscription plan. See Rate Limits for plan-based daily limits.

Behöver du hjälp?