Skip to main content

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).

quando

3. vuoiClicca automatizzareCrea. operazioniIl cometoken ilcompare downloaduna dellesola donazioni,volta: lacopialo gestionesubito.

dei

Il sostenitoritoken oè qualsiasilegato altraall'organizzazione integrazionee programmaticanon conscade. laVa piattaforma.in ogni richiesta nell'intestazione Authorization: Bearer IL_TUO_TOKEN.

ProceduraIndirizzi

Riseact

espone due tipi di endpoint API:
  • REST API: https://core.riseact.org/admin/api/v1/
  • GraphQL: https://core.riseact.org/admin/graphql/

Per autenticarti

REST: allehttps://core.riseact.org/api/v1/. API[DA èVERIFICARE: necessariola utilizzareguida leper credenzialisviluppatori oscrive il/api/v1/, tokenla versione precedente di accessoquesta disponibilipagina nellescriveva impostazioniche del tuo account Riseact.

Note operative

  • Il dominio corretto è riseact.org — non usare riseact.com.
  • Il path REST include obbligatoriamenteserve il prefisso /admin/:]
l'endpointIl dominio è /api/v1/riseact.org senza prefisso, non èriseact.com. valido

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

    Errore di risorsa non trovata.L'endpointtrovata: GraphQLcontrolla si trova su /admin/graphql/indirizzo e consentedominio query(riseact.org): vedi il punto da verificare sopra. Errore di autorizzazione: manca un permesso: :write non include :read, per leggere e mutazioniscrivere strutturate.servono entrambi.

    Da verificare

    • ConfermareIl token è compromesso: rigeneralo da Impostazioni > App > Applicazioni private: il metodoprecedente smette subito di autenticazionefunzionare.
    supportato

    Vedi (tokenanche

    Bearer,Esportare APIsostenitori, key, OAuth)donazioni e documentarlopagamenti inCollegare questaRiseact pagina.Verificarea seDonodoo esistee documentazionemappare OpenAPIi o schema GraphQL pubblico da linkare.Verificare se esistono limitazionimetodi di ratepagamento limiting o restrizioni per tipo di piano.