Documentazione API Mokapen

Panoramica

Le API Mokapen sono REST. Ogni richiesta deve includere un header valido Authorization: Bearer <access_token>, salvo diversa indicazione.

Base URL: https://mokapen.com/api

Prefisso versione API: v1 (esempio: /api/v1/{org_id}/contacts).

Passo 1 — Crea un'applicazione

Accedi a Mokapen, apri la tua organizzazione e vai su Account → Developer → Le mie applicazioni. Da lì puoi vedere le app esistenti o crearne una nuova.

Mokapen supporta due tipi di applicazione:

• App public — pensata per integrazioni usate da più utenti Mokapen. Usa il flusso OAuth 2.0 authorization code. Gli utenti autorizzano la tua app e scelgono a quale organizzazione concedere l'accesso.
• App private — pensata per automazioni interne alla tua organizzazione. Usa il grant client_credentials. I token si generano dalla dashboard Developer senza redirect OAuth per l'utente finale.

Requisiti dell'applicazione

Passo 2 — Seleziona gli scope API

Dopo aver compilato i dati dell'applicazione, clicca Continua per scegliere gli scope (permessi) necessari, poi salva l'applicazione.

Solo gli scope abilitati in fase di setup possono essere richiesti in autorizzazione (app public) o inclusi nei token (app private).

Passo 3 — Attivazione e credenziali

Le applicazioni private vengono attivate subito dopo la creazione. Owner e admin dell'organizzazione possono disattivarle o riattivarle in qualsiasi momento dalla pagina dell'app.

Le applicazioni public partono come In attesa di approvazione. Mokapen revisiona gli scope richiesti prima di attivare l'app. Quando lo stato è Active, apri la tab Credentials per ottenere client_id e client_secret e avviare il flusso OAuth authorization code.

Se modifichi gli scope su un'applicazione public già attiva, torna in attesa di approvazione e i token esistenti vengono revocati.

Conserva le credenziali in modo sicuro. Non esporre mai il client secret nel codice client-side o in repository pubblici.

Prossimi passi

• App public → segui la guida Autenticazione (OAuth authorization code).
• App private → genera un token dalla tab Credentials, poi vedi Token app private.
• Esplora gli endpoint nel Riferimento API.