Accedere alle API di Riseact
Scopo
QuestaGli esempi e gli screenshot di questa pagina descriveusano comeun'associazione accedereinventata, alleSave 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 perpermettono integrare odi automatizzare operazioni tramitecome scaricare le donazioni o gestire i sostenitori da script, applicazioni esterne, scriptesterne o strumenti di terze parti.
QuandoOttenere usareil token
Usa1. 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 APIdonazioni diserve Riseactdonation:read).
3. vuoiClicca automatizzareCrea. operazioniIl cometoken ilcompare downloaduna dellesola donazioni,volta: lacopialo gestionesubito.
Il sostenitoritoken oè qualsiasilegato altraall'organizzazione integrazionee programmaticanon conscade. laVa piattaforma.in ogni richiesta nell'intestazione Authorization: Bearer IL_TUO_TOKEN.
ProceduraIndirizzi
Riseact
REST API:https://core.riseact.org/admin/api/v1/- GraphQL:
https://core.riseact.org/admin/graphql/
Per
autenticarti
https://core.riseact.org/api/v1/. /api/v1/, Note operative
Il dominio corretto èriseact.org— non usareriseact.com.Il path REST include obbligatoriamenteserve il prefisso/admin/:]
/api/v1/riseact.orgriseact.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 restituiscedai erroreall'applicazione solo i permessi che le servono.
Problemi comuni
/admin/graphql/indirizzo e Da
verificare
ConfermareIl token è compromesso: rigeneralo da Impostazioni > App > Applicazioni private: ilmetodoprecedente smette subito diautenticazionefunzionare.