Le chiavi API vengono generate dalla pagina Admin / API. Vai su Admin-Avanzate-Chiavi API:
Dopo aver fatto clic sul pulsante “Nuova chiave API”, verrai indirizzato a una pagina per configurare la chiave:
Ogni chiave API necessita di una descrizione, un livello utente e uno scope (ambito).
Descrizione
La descrizione può essere qualsiasi cosa tu scelga.
Livello Utente
Il menu a discesa Livello Utente ti consente di selezionare “Tutti gli utenti” o “Utente singolo”. Se è selezionato “Tutti gli utenti”, la chiave può essere utilizzata per conto di qualsiasi utente. Ciò si ottiene impostando l’utente per conto del quale si sta effettuando la richiesta come Api-Username nelle intestazioni della richiesta. (Vedi l’esempio di Autenticazione nella documentazione API per i dettagli su come impostare le intestazioni della richiesta.)
Se è selezionato “Utente singolo”, apparirà un campo utente nel modulo. Inserisci il nome utente dell’utente per il quale stai generando la chiave API in quel campo:
Scope (Ambito)
Il menu a discesa Scope ti consente di selezionare “Granulare”, “Sola lettura” o “Globale” come ambito.
Se “Sola lettura” è selezionato come ambito, la chiave API potrà essere utilizzata solo per effettuare richieste GET. La chiave sarà in grado di effettuare qualsiasi richiesta GET che l’utente per cui è stata generata la chiave, o il nome utente inserito come Api-Username della richiesta, ha il permesso di eseguire.
Se è selezionato “Globale” come ambito, la chiave può essere utilizzata per qualsiasi richiesta che l’utente per cui è stata generata la chiave, o il nome utente inserito come Api-Username della richiesta, ha il permesso di eseguire.
Se è selezionato “Granulare” come ambito, si aprirà un modulo che ti consentirà di selezionare dagli ambiti disponibili. Passa con il mouse sull’icona del punto interrogativo di un ambito per vedere una descrizione dell’ambito. Fai clic sull’icona del collegamento dell’ambito per vedere un elenco di percorsi e metodi di richiesta supportati dall’ambito. Nota che molti degli ambiti ti consentono di inserire un parametro aggiuntivo per limitare i percorsi sul sito a cui l’ambito consentirà l’accesso:
Dopo aver configurato la chiave API e aver fatto clic sul pulsante Salva, la chiave API completa ti verrà mostrata una sola volta. Assicurati di copiare la chiave poiché non c’è modo di visualizzare nuovamente la chiave completa.
Gli ambiti API in Discourse possono solo limitare le azioni che una chiave API può eseguire rispetto alle autorizzazioni esistenti dell’utente. Non possono concedere autorizzazioni aggiuntive oltre a quelle che l’utente associato possiede già.
Letture aggiuntive
Dettagli sui limiti di frequenza che Discourse applica alle chiavi API: Limiti di frequenza globali e throttling in Discourse.
Documentazione API di Discourse: https://docs.discourse.org/.
Una guida utile per capire come strutturare le richieste API: Come eseguire l’ingegneria inversa dell’API di Discourse.
.
