Accedere alle API di Riseact
Gli esempi e gli screenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.
Il tecnico di Save The Unicorns deve scaricare le donazioni con uno script. Gli serve un token e l'indirizzo giusto.
A cosa serve
Le API di Riseact permettono di automatizzare operazioni come scaricare le donazioni o gestire i sostenitori da script, applicazioni esterne o strumenti di terze parti.
Ottenere il token
1. Vai in Impostazioni > App > Applicazioni private e clicca Nuova applicazione privata.
2. Dai un nome, per esempio Sync CRM, e seleziona i permessi (per leggere le donazioni serve donation:read).
3. Clicca Crea. Il token compare una sola volta: copialo subito.
Il token è legato all'organizzazione e non scade. Va in ogni richiesta nell'intestazione Authorization: Bearer IL_TUO_TOKEN.
Indirizzi
- GraphQL:
https://core.riseact.org/admin/graphql/ - REST:
https://core.riseact.org/api/v1/. - Il dominio è
riseact.org, nonriseact.com.
Permessi, esempi ed elenco degli endpoint sono nel manuale API & Developer Guide: Integrarsi con Riseact.
Consiglio di fundraising
Tratta il token come una password: non metterlo nel codice che condividi e dai all'applicazione solo i permessi che le servono.
Problemi comuni
- Errore di risorsa non trovata: controlla indirizzo e dominio: REST risponde su
https://core.riseact.org/api/v1/(senza/admin/), GraphQL su/admin/graphql/; il dominio è riseact.org. - Errore di autorizzazione: manca un permesso: :write non include :read, per leggere e scrivere servono entrambi.
- Il token è compromesso: rigeneralo da Impostazioni > App > Applicazioni private: il precedente smette subito di funzionare.