Se il tuo sito web ha iscrizioni, programmi o prodotti, puoi decidere a quali gruppi di utenti del forum appartiene ciascun membro. Il tuo sito web stabilisce le regole e trasmette gli ID dei gruppi al forum, in modo che l'accesso di un membro al forum corrisponda sempre alla sua appartenenza al tuo sito web.
Come funziona
- Quali gruppi assegnare. Il tuo sito web elabora i gruppi giusti per ogni membro e li trasmette al forum.
- Se avviare il Single Sign-On. Se i prodotti o i programmi dei membri sono scaduti, il tuo sito Web semplicemente non li registra nel forum.
Il forum non legge mai da solo i tuoi dati di iscrizione. Tutto è guidato dal tuo sito web.
Prima di iniziare
- Ottieni la tua chiave API. Ne hai bisogno per ogni richiesta in questo articolo.
- Ottieni l'ID di ogni gruppo di utenti che desideri assegnare, ad esempio un gruppo per programma.
Assegna gruppi quando viene creato un account
Includi il parametro UserGroups nella tua richiesta di accesso Single Sign-On. Se l'account non esiste ancora, viene creato con quei gruppi.
Separa più ID con virgole. Questi gruppi si applicano quando l'account viene creato per la prima volta. Per cambiare gruppo in un secondo momento, utilizza le richieste API nella sezione successiva.
Aggiorna i gruppi quando cambia l'appartenenza
Quando un membro acquista, aggiorna o perde un programma sul tuo sito web, aggiorna i suoi gruppi di forum con l'API Website Toolbox. Queste richieste vengono eseguite dal tuo server, quindi puoi farle nel momento in cui avviene la modifica. Non è necessario che il membro sia loggato.
Aggiorna tutti i gruppi di un membro in un'unica richiesta
Per apportare più modifiche contemporaneamente, ad esempio aggiungere un membro a due gruppi e rimuoverlo da uno, invia una richiesta all'endpoint del membro con ogni gruppo a cui dovrebbe appartenere. I gruppi inviati sostituiscono i gruppi attuali del membro, quindi includi tutti i gruppi che desideri che mantengano.
Per vedere i gruppi attuali del membro prima di sostituirli, invia una richiesta GET allo stesso indirizzo.
La risposta include gli attuali UserGroups del membro.
Aggiungere o rimuovere un gruppo
Quando devi concedere o revocare solo un singolo gruppo, utilizza invece l'endpoint del gruppo in modo da non dover inviare l'elenco completo.
USER_ID è l'ID utente del forum del membro, che la richiesta di accesso restituisce quando viene creato l'account. Puoi passare nomi utente o indirizzi email anziché ID utente. Un indirizzo email di qualcuno che non ha ancora un account sul forum invia invece un invito al gruppo.
Decidere chi può accedere
Il tuo sito web verifica l'iscrizione del membro prima di avviare il Single Sign-On. Se ha ancora accesso, accedi con il token come descritto in Single Sign On - Autenticazione basata su token. Se i loro prodotti sono scaduti, non attivate il Single Sign-On e non accederanno al forum.
Domande frequenti
Devo aggiornare i gruppi dei membri o utilizzare l'endpoint del gruppo?
Invia l'elenco completo dei gruppi all'endpoint del membro quando modifichi più gruppi contemporaneamente. Usa l'endpoint del gruppo quando aggiungi o rimuovi solo un gruppo.
Quando devo aggiornare i gruppi di utenti di un membro?
Aggiorna i gruppi ogni volta che l'iscrizione del membro cambia sul tuo sito web, ad esempio un acquisto, un upgrade o una scadenza. Non è necessario attendere il prossimo accesso del membro.
Il membro deve essere loggato per poter aggiornare i gruppi?
No L'aggiornamento è una richiesta API dal tuo server, quindi funziona indipendentemente dal fatto che il membro abbia effettuato l'accesso o stia visitando il forum.
Che cos'è curl?
Curl è uno strumento a riga di comando per l'invio di richieste HTTP incluso in macOS, Linux e nelle versioni recenti di Windows, motivo per cui gli esempi in questo articolo sono scritti come comandi curl. Puoi inviare esattamente le stesse richieste da qualsiasi linguaggio di programmazione utilizzando i suoi strumenti HTTP standard, con gli stessi parametri in ogni lingua. Vedi Codice di esempio per effettuare una richiesta HTTP per esempi in diverse lingue.
Perché una richiesta API non riesce?
Verifica che la chiave API corrisponda alla chiave API del tuo forum, che l'ID del gruppo e l'ID utente siano corretti e che il membro abbia già un account sul forum.