Aller au contenu

API

L’API REST de Cassiope (api.lab.cassiope.eu/v1) expose toute la surface de gestion.

Chaque requête porte un jeton (Authorization: Bearer <token>) et cible un tenant via l’en-tête X-Tenant-Slug. L’isolation (RLS), le RBAC et les quotas sont appliqués côté serveur.

  • Enveloppe — toutes les réponses suivent { success, data, error, meta? }.
  • Asynchrone (202 + polling) — les actions longues (deploy, provision add-on, backup, verify domaine…) répondent immédiatement avec une ressource en statut transitoire ; interrogez le GET de la ressource jusqu’à un statut terminal.
  • Pagination — page / limit, avec meta.total.

La référence par ressource (tenants, projets, environnements, services, déploiements, variables, domaines, add-ons, backups, bindings, consultation, observabilité, facturation) suit la surface /v1. Voir aussi MCP pour piloter cette même surface via un agent IA.

Référence détaillée par endpoint à compléter.