SmartFlow Host

Référence de l'API

Lister les équipes

Renvoie l'équipe de la clé.

GET/v2/teams

La liste ne contient que cette équipe. Une clé n'ouvre jamais qu'une équipe.

Requête

En-têtes

Authorizationstringrequis
Bearer ah_…, votre clé d'API.
curl https://api.host.hgdc.ch/v2/teams \
  -H "Authorization: Bearer $SMARTFLOW_HOST_TOKEN"

Réponse

200
{
  "teams": [
    {
      "id": "k57a1b2c3d4e5f6g7h8j9k0m1n",
      "slug": "atelier",
      "name": "Atelier Rochat",
      "avatar": null,
      "membership": { "role": "OWNER" }
    }
  ],
  "pagination": { "count": 1, "next": null, "prev": null }
}

Lire une équipe

GET/v2/teams/:idOrSlug

Paramètres de chemin

idOrSlugstringrequis
Identifiant ou slug de l'équipe de la clé. Toute autre équipe répond 404.
curl https://api.host.hgdc.ch/v2/teams/atelier \
  -H "Authorization: Bearer $SMARTFLOW_HOST_TOKEN"

La réponse est l'objet équipe seul, sans liste. Les deux routes répondent aussi sous /v1.

Erreurs

StatutCodeQuand
404not_foundL'équipe demandée n'est pas celle de la clé.

Toutes les routes peuvent aussi répondre 403 forbidden, 429 rate_limited et 500 internal_server_error. Voir Erreurs.