Documentation API

Authentification

Les appels serveur à serveur utilisent une clé d’API créée depuis l’application. La clé n’est affichée qu’une fois : seul son empreinte est conservée.

curl https://api.shieldgmb.iprotego.net/api/v1/locations \
  -H "Authorization: Bearer sgmb_votre_cle" \
  -H "Accept: application/json"

Filtres, tris et pagination

Les collections volumineuses utilisent une pagination par curseur, stable même si des enregistrements sont ajoutés pendant le parcours.

GET /api/v1/locations?filter[status]=active&sort=-created_at&per_page=50

{
  "data": [ ... ],
  "meta": { "next_cursor": "eyJpZCI6NDJ9", "prev_cursor": null }
}

Format d’erreur

Toutes les erreurs suivent la même structure, quel que soit le code HTTP.

{
  "message": "Le champ nom de la bulle est obligatoire.",
  "errors": {
    "name": ["Le champ nom de la bulle est obligatoire."]
  }
}

Webhooks et connecteurs

Les webhooks sortants sont signés en HMAC : vérifiez l’en-tête X-ShieldGMB-Signature avant de traiter la charge utile. Un serveur MCP permet également de piloter la plateforme depuis un assistant IA.