API Drexo

Drexo expose progressivement une API publique pour intégrer la plateforme dans des outils tiers — extraction de données, alertes sortantes, gestion automatisée des partages, etc.

Statut — aucun endpoint encore publié en production. La spec OpenAPI ci-dessous est un aperçu du format que nous publierons : pas la peine d'essayer le bouton try-it-out tant que la version 1.0 n'est pas annoncée dans les notes de version.

Authentification

L'authentification reposera sur les mêmes JWT Supabase que l'interface web :

• Header Authorization: Bearer <token>.
• Le token s'obtient via la session navigateur après connexion (Microsoft / Google SSO, lien magique, ou mot de passe).
• Chaque appel hérite des droits RLS de l'utilisateur qui a généré le token — aucun accès service_role n'est exposé publiquement.

Aperçu : lire un appareil

L'endpoint ci-dessous illustre ce à quoi ressemblera la documentation d'un vrai endpoint quand il sera publié : description, paramètres, réponses, exemples par code de retour, schéma TypeScript généré automatiquement, et bouton Try-it-out pour tester depuis le navigateur.

curl -X GET "https://example.com/api/v0/devices/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "id": "8b3a52f0-9421-44b3-90dc-1c0f0b9e8b41",
  "slug": "I25VA054179",
  "name": "Compteur principal — Villa Estate",
  "type": "water_meter",
  "owner_tenant_id": "d7e2a4f0-1111-4dde-9b21-aa11bbcc44ee",
  "created_at": "2026-03-04T09:12:48Z"
}

{
  "error": "unauthenticated",
  "message": "Token manquant ou invalide."
}

{
  "error": "device_not_found",
  "message": "Cet appareil n'existe pas ou vous n'y avez pas accès."
}

Versionnement

L'API suivra le semver : v0 est l'espace de noms des endpoints en aperçu (changements possibles sans préavis). À partir de la stabilisation, les endpoints publieront sous v1 et toute modification breaking incrémentera la version majeure (et un ADR public sera ouvert).

S'abonner aux évolutions

Suivez les notes de version — chaque ouverture d'un nouvel endpoint sera annoncée là, avec un changelog machine-readable côté RSS et JSON Feed.