Référence API

Une API REST JSON servie sous /api/v1. Générez un jeton d'accès personnel depuis Jetons API et envoyez-le en tant que jeton porteur.

Authentification

Toutes les requêtes nécessitent un en-tête Authorization. Les jetons sont limités par portée — un appel échoue avec 403 si le jeton n'a pas la capacité requise.

curl https://rank.g-hyksos.com/api/v1/user \
  -H "Authorization: Bearer nx_your_token_here" \
  -H "Accept: application/json"

Obtenir l'utilisateur actuel

GET /api/v1/user

{
  "data": {
    "id": 1,
    "name": "Jane Cooper",
    "email": "jane@company.com",
    "is_admin": false,
    "workspaces_count": 3
  }
}

Lister les espaces de travail

GET /api/v1/workspaces · nécessite workspaces:read

{
  "data": [
    { "id": 1, "name": "Acme", "slug": "acme", "members_count": 5 }
  ]
}

Créer un espace de travail

POST /api/v1/workspaces · nécessite workspaces:write

curl -X POST https://rank.g-hyksos.com/api/v1/workspaces \
  -H "Authorization: Bearer nx_your_token" \
  -H "Content-Type: application/json" \
  -d '{ "name": "New workspace" }'

Erreurs

Codes de statut HTTP standards. Les erreurs de validation renvoient 422 avec un objet message et errors ; les portées manquantes renvoient 403.