Skip to main content

Accedere alle API di Riseact

Il tecnico di Save The Unicorns deve scaricare le donazioni con uno script. Gli serve un token e l'indirizzo giusto.

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, non riseact.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.

Vedi anche