Documentazione API Mokapen

Organizzazioni

La maggior parte degli endpoint Mokapen è scoped su una singola organizzazione. Il contesto organizzazione è definito sia nell'URL sia nel token di accesso.

Organization ID nell'URL

Gli endpoint sulle entità seguono questo pattern:

GET /api/v1/{org_id}/contacts
GET /api/v1/{org_id}/tasks
POST /api/v1/{org_id}/store_contact
Sostituisci {org_id} con l'ID numerico dell'organizzazione. Alcune integrazioni possono usare un identificativo organizzazione cifrato; l'API accetta entrambi i formati dove supportato.

Vincolo organizzazione sul token

I token emessi per le applicazioni developer includono un organization_id (salvato nel record token e presente nella risposta OAuth).

Quando chiami un endpoint con {org_id} nell'URL, Mokapen verifica che il token sia autorizzato per quell'organizzazione. Se l'organizzazione nell'URL non coincide con quella del token, l'API risponde 403 Forbidden.

  • App private — l'organizzazione viene impostata automaticamente alla generazione del token (in base all'organizzazione attiva nella dashboard Developer).
  • App public — l'utente finale seleziona l'organizzazione durante il consenso OAuth.

Endpoint elenco organizzazioni

Per ottenere le organizzazioni accessibili all'utente o all'integrazione autenticata:

GET /api/v1/organizations

Premium organizzazione e accesso API

Disponibilità API e quote giornaliere dipendono dal piano Mokapen dell'organizzazione. Vedi Limiti API per i limiti per piano.

Inizia a lavorare risparmiando tempo.

oppure
Prenota una demo

Hai bisogno di aiuto?