Introduction

L’API REST de SupportDesk permet à votre backend de piloter SupportDesk sans passer par le widget : créer des tickets automatiquement, synchroniser vos clients, enregistrer des événements métier qui apparaîtront dans la timeline de vos agents.

Cas d’usage typiques

• Créer un ticket quand un paiement échoue côté votre app
• Synchroniser le profil client (plan, email, téléphone) dès qu’il change chez vous
• Enrichir le contexte d’un ticket avec des événements métier (order.placed, subscription.cancelled)

Base URL

https://supportdesk.innovartx.com/api/v1

Format

• Requêtes et réponses en JSON (Content-Type: application/json)
• Authentification via le header X-API-Key: sk_live_agent_… (clé API créée dans Paramètres → Clés API)
• Réponses enveloppées :

  { "success": true, "data": { /* … */ }, "timestamp": "2026-04-18T10:00:00Z" }

Endpoints disponibles

Endpoint	Action
PATCH /customers/:externalId	Créer ou mettre à jour un client
POST /tickets/api-create	Créer un ticket pour un client existant
POST /customer-events	Enregistrer un événement métier

Versioning

L’API est versionnée via le préfixe d’URL (/v1). Tant que vous restez sur une version, les endpoints et leurs formats ne cassent pas. Les ajouts non-breaking (nouveaux champs, nouveaux endpoints) sont annoncés dans le changelog.

Prochaine étape

→ Commencez par Authentification.