Las claves de API se generan desde la página de Administración / API. Vaya a Administración-Avanzado-Claves de API:
Después de hacer clic en el botón “Añadir clave de API”, será dirigido a una página para configurar la clave:
Cada clave de API necesita una descripción, un nivel de usuario y un alcance.
Descripción
La descripción puede ser cualquier cosa que elija.
Nivel de Usuario
El menú desplegable Nivel de Usuario le permite seleccionar “Todos los Usuarios” o “Usuario Único”. Si se selecciona “Todos los Usuarios”, la clave se puede usar en nombre de cualquier usuario. Esto se hace configurando el usuario en cuyo nombre está realizando la solicitud como el Api-Username en las cabeceras de la solicitud. (Consulte el ejemplo de Autenticación en la documentación de la API para obtener detalles sobre cómo configurar las cabeceras de la solicitud).
Si se selecciona “Usuario Único”, aparecerá un campo de usuario en el formulario. Introduzca el nombre de usuario para el que está generando la clave de API en ese campo:
Alcance
El menú desplegable Alcance le permite seleccionar “Global”, “Solo lectura” o “Granular” como alcance.
Si se selecciona “Global” como alcance, la clave se puede utilizar para todas las solicitudes que el usuario para el que se generó la clave, o el nombre de usuario introducido como Api-Username de la solicitud, tenga permiso para realizar.
Si se selecciona “Solo lectura” como alcance, la clave de API solo podrá utilizarse para realizar solicitudes GET. La clave podrá realizar cualquier solicitud GET que el usuario para el que se generó la clave, o el nombre de usuario introducido como Api-Username de la solicitud, tenga permiso para realizar.
Si se selecciona “Granular” como alcance, se abrirá un formulario que le permitirá seleccionar entre los alcances disponibles. Pase el ratón por encima del icono de interrogación de un alcance para ver una descripción del mismo. Haga clic en el icono de enlace del alcance para ver una lista de rutas y métodos de solicitud que admite el alcance. Tenga en cuenta que muchos de los alcances le permiten introducir un parámetro adicional para limitar qué rutas del sitio permitirá acceder el alcance:
Después de configurar la clave de API y hacer clic en el botón Guardar, se le mostrará la clave de API completa una sola vez. Asegúrese de copiar la clave ya que no hay forma de ver la clave completa de nuevo.
Los alcances de API en Discourse solo pueden restringir las acciones que una clave de API puede realizar en relación con los permisos existentes del usuario. No pueden otorgar permisos adicionales más allá de lo que ya tiene el usuario asociado.
revoke_api_keys_unused_days.
Lectura adicional
Detalles sobre los límites de tasa que Discourse aplica a las claves de API: Límites de tasa globales y limitación en Discourse.
Documentación de la API de Discourse: https://docs.discourse.org/.
Una guía útil para averiguar cómo estructurar las solicitudes de API: Cómo realizar ingeniería inversa de la API de Discourse.
.
