๐๏ธ Creare un account partner
Per poter pubblicare le tue applicazioni e temi per le organizzazioni presenti su Riseact, รจ necessario creare un account Partner. Segui i passaggi di seguito per creare il tuo account Partner:
๐๏ธ Utilizzo delle APIs
Riseact offre 2 modi per consumare le APIs: tramite GraphQL o REST. Per utilizzare le APIs GraphQL, puoi inviare una richiesta HTTP POST al server GraphQL di Riseact, specificando il token di accesso come header di autorizzazione.
๐๏ธ Creare un applicazione partner
Per poter interagire con le APIs di Riseact รจ necessario creare un applicazione. Segui i passaggi descritti in questa pagina per crearne una.
๐๏ธ Autenticazione con OAuth
L'implementazione dell'autenticazione OAuth รจ essenziale per ottenere un Access Token e poter utilizzare le API. Segui i passaggi di questa guida per comprendere il processo di OAuth e integrarlo correttamente nella tua applicazione.
๐๏ธ Interfaccia utente dell'applicazione
Le applicazioni di Riseact vengono renderizzate all'interno di un iframe incorporato nel portale di amministrazione nella pagina della tua applicazione. Se vuoi fornire una interfaccia dell'applicazione ai tuoi utenti, puoi farlo servendola all'url che hai fornito in fase di registrazione dell'applicazione.
๐๏ธ Webhook di Organizzazione
I webhook di organizzazione sono webhook che vengono chiamati da Riseact quando si verificano determinati eventi in una organizzazione. Per aggiungere un webhook di organizzazione, devi registrare l'URL del webhook e selezionare gli eventi che vuoi ricevere con la chiamata al relativo endpoint o mutation.
๐๏ธ Webhook di Applicazione
I webhook di applicazione sono webhook che vengono chiamati da Riseact quando si verificano determinati eventi in tutte le organizzazioni che che hanno installato l'applicazione. A differenza dei webhook di organizzazione, questi vengono registrati una sola volta (per esempio alla creazione dell'applicazione) e i riferimenti all'organizzazione saranno inclusi nel payload della chiamata.
๐๏ธ Pubblicazione
Una volta completata e testata la tua applicazione, puoi pubblicarla su Riseact im modo che sia a disposizione di tutti gli utenti. Per pubblicare la tua applicazione, devi andare alla pagina impostazioni della tua app e modificare la distribuzione dell'app da Privata a Pubblica.