API REST

Développez à partir de vos projets Skimle

Un point de terminaison unique par sens — lecture ou écriture — pour chaque ressource de projet. Authentifiez-vous avec une clé d'API propre au projet, envoyez une action en JSON, recevez du JSON en retour.

Démarrez en trois étapes

De zéro à votre premier appel authentifié.

1

Créer une clé d'API

Les clés d'API sont limitées à un seul projet et à un seul niveau d'accès (lecture ou écriture).

  1. 1. Ouvrez la page des clés d'API
  2. 2. Choisissez le projet auquel la clé doit accéder, puis l'accès en lecture ou en écriture
  3. 3. Copiez la clé — Skimle n'en conserve que l'empreinte

Copiez la clé immédiatement.

La valeur complète de la clé n'est affichée qu'une seule fois, à sa création. Une fois la fenêtre fermée, seule l'empreinte subsiste de notre côté : une clé perdue doit être réémise.

2

Envoyer votre première requête

Transmettez la clé comme jeton Bearer et l'action dans le corps JSON. Chaque point de terminaison reçoit du JSON et renvoie du JSON.

curl -X POST https://app.skimle.com/api/skimle-read \
  -H "Authorization: Bearer skm_…r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "get_categories" }'

Les clés de lecture se terminent par r et ne peuvent appeler que /api/skimle-read. Les clés d'écriture se terminent par e et peuvent appeler les deux points de terminaison.

3

Ouvrir la référence de l'API

Parcourez chaque point de terminaison avec ses descriptions, la structure des requêtes et un panneau d'essai. Chaque route accepte un corps en union discriminée, sur la clé action.

La spécification OpenAPI 3.1 brute est disponible sur /api/openapi.json.

Prêt à développer ?

Gérez les clés de vos projets, ou découvrez le serveur MCP pour les clients agentiques.