API REST

Développez à partir de vos projets Skimle

Des points de terminaison JSON pour lire et écrire les données de projet, et pour mener un projet de bout en bout. Authentifiez-vous avec une clé Bearer, envoyez une action, recevez du JSON en retour.

Démarrez en trois étapes

De zéro à votre premier appel authentifié.

1

Créer une clé d'API

Une clé de projet atteint un seul projet. Une clé de compte atteint une seule équipe et peut y créer des projets. Les deux existent en niveau lecture et en niveau é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, les clés d'écriture par e. Les clés de projet appellent /api/skimle-read et /api/skimle-write. Les clés de compte appellent /api/skimle-account.

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.