Découvrez notre API

Pour le moment, vous pouvez uniquement récupérer les articles générés via notre plateforme.

Nous publions aussi une documentation technique plus détaillée, disponible ici. Vous y trouverez une collection Postman à jour et une specification OpenAPI. Cette documentation est générée par Scribe.

Si vous trouvez un bug ou avez besoin d'aide pour utiliser notre API, n'hésitez pas à nous contacter : team@sitedojo.com.

Sauf mention contraire, tous les appels à notre API sont gratuits.

Générer un Bearer Token

Pour générer un token, rendez-vous sur votre dashboard puis cliquez sur "API Tokens". Entrez un nom pour votre token, cliquez sur "créer" et copiez le token généré. Attention, ce token ne s'affiche qu'une fois en clair. Vous ne pourrez pas le récupérer par la suite.

Authentification

Chaque requête vers nos serveurs doit être accompagnée de son Bearer Token.

curl --request GET \
--get "http://sitedojo.test/api/{endpoint}" \
--header "Authorization: Bearer {YOUR_API_TOKEN}"

Endpoint

Toutes les routes doivent être préfixées par https://sitedojo.com/api

Articles

GET /article

Renvoie la liste des articles disponibles sur la plateforme, les plus récents en premier. Vous aurez besoin de l'ID de l'article pour pouvoir l'exporter.

GET /article/{article_id}/export/html

Renvoie le contenu d'un article, formaté en HTML.

GET /article/{article_id}/export/markdown

Renvoie le contenu d'un article, formaté en markdown.