Démarrage rapide

Démarrage rapide

De la création d’un jeton à votre première procédure créée par programme. Les exemples utilisent curl ; n’importe quel langage qui sait faire une requête HTTP convient.

1Créer un jeton

Dans l’application, ouvrez Paramètres › Options d’application › Mes jetons d’API, puis « Créer un jeton ». Donnez-lui un nom, cochez les droits dont votre programme a besoin, choisissez une durée.

Ouvrir les jetons d’API

Le jeton n’est affiché qu’une fois : copiez-le aussitôt et rangez-le comme un mot de passe. Pour un programme qui doit survivre au départ de son auteur, un administrateur peut créer un jeton d’organisation.

2Premier appel

Chaque requête présente le jeton dans l’en-tête Authorization. Demandez d’abord à l’API qui vous êtes :

Commande
curl https://beta.unwind-app.com/api/v1/me \
  -H "Authorization: Bearer saw_pat_…"
Réponse
{
  "id": 42,
  "name": "Camille Martin",
  "kind": "user",
  "organisation_id": null,
  "scopes": ["read", "write"]
}

3Lire vos procédures

Vos classeurs et procédures vivent dans des espaces ; « me » est le vôtre. Listez ce qu’il contient, puis lisez les étapes d’une procédure :

Commande
# Ce qui se trouve à la racine de votre espace
curl https://beta.unwind-app.com/api/v1/spaces/me \
  -H "Authorization: Bearer saw_pat_…"

# Les étapes de la procédure 128, dans l’ordre
curl https://beta.unwind-app.com/api/v1/flows/128/steps \
  -H "Authorization: Bearer saw_pat_…"

Dans l’API, une procédure s’appelle flow et un classeur binder.

4Créer une procédure

Avec le droit « Modifier ». La procédure naît hors ligne, avec une première étape vide dans son brouillon.

Commande
curl -X POST https://beta.unwind-app.com/api/v1/flows \
  -H "Authorization: Bearer saw_pat_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: onboarding-2026-10-05" \
  -d '{"name": "Accueil des nouveaux arrivants"}'

L’en-tête Idempotency-Key est facultatif : renvoyée avec la même clé, la requête n’est pas exécutée deux fois. Remplissez ensuite les étapes, reliez-les par des boutons, puis publiez et mettez en ligne — deux gestes distincts, qui demandent le droit « Publier ».

5En cas d’erreur

Une erreur revient toujours sous la même forme : « code » est fait pour votre programme, « detail » pour vous. Ici, le jeton n’a pas le droit de publier :

Réponse
{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "",
  "scope": "publish"
}

Un identifiant que le compte n’a pas le droit d’ouvrir répond comme un identifiant qui n’existe pas : 404 not_found.

Et ensuite

Référence de l’API — toutes les routes, leurs paramètres et leurs erreurs.

Connecter un assistant — le même accès, sans écrire de code.

planner_banner_ad_pt