Discourse está respaldado por una API JSON completa. Todo lo que puedes hacer en el sitio también lo puedes hacer usando la API JSON.
La API está documentada en docs.discourse.org. También puedes usar la gema de Ruby discourse_api como biblioteca cliente. Sin embargo, no todos los endpoints están documentados.
Para determinar cómo hacer algo con la API JSON, puedes seguir estos pasos.
Ejemplo: Recategorizar un tema.
- Ve a un tema y comienza a editar una categoría:
- Abre las herramientas de desarrollador de Chrome, cambia a la pestaña Red (Network), selecciona el filtro Fetch/XHR:
- Realiza la operación
- Los datos de la solicitud se mostrarán en la pestaña “Payload” (Carga útil)
- Mira también la vista previa (preview) para determinar los resultados
- Ahora tienes toda la información que necesitas.
-
El endpoint es
https://try.discourse.org/t/online-learning/108.json -
El Payload se pasa usando un
PUT -
El parámetro enviado es:
category_id: 5
Con esta información, puedes realizar tus propias llamadas usando tu lenguaje de programación favorito. Todo lo que necesitas hacer es agregar tu Api-Username y Api-Key a las cabeceras de la solicitud. (Consulta Discourse REST API Documentation para obtener detalles sobre cómo formular una solicitud curl a la API de Discourse).
Las credenciales de la API se pueden generar desde el panel de administración en /admin/api/keys:
