Las claves de API se generan desde la página Administrador / API. Vaya a Administrador-Avanzado-Claves de API:
Después de hacer clic en el botón “Nueva 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 usted 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 estableciendo 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. Ingrese el nombre de usuario para el que está generando la clave de API en ese campo:
Alcance
El menú desplegable Alcance le permite seleccionar “Granular”, “Solo lectura” o “Global” como alcance.
Si se selecciona “Solo lectura” como alcance, la clave de API solo podrá usarse 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 ingresado como Api-Username de la solicitud, tenga permiso para realizar.
Si se selecciona “Global” como alcance, la clave se puede usar para cualquier solicitud que el usuario para el que se generó la clave, o el nombre de usuario ingresado 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 cursor sobre el ícono de signo de interrogación de un alcance para ver una descripción del alcance. Haga clic en el ícono de enlace del alcance para ver una lista de rutas y métodos de solicitud que el alcance admite. Tenga en cuenta que muchos de los alcances le permiten ingresar un parámetro adicional para limitar las rutas del sitio a las que el alcance permitirá el acceso:
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 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 qué acciones puede realizar una clave de API 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.
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 descubrir cómo estructurar las solicitudes de API: Cómo realizar ingeniería inversa de la API de Discourse.
.
