🔌 API & Intégrations

Connectez tout à DossierHQ

API REST documentée, webhooks temps réel, SSO, SDK officiels. DossierHQ s'intègre à votre écosystème existant — pas l'inverse.

✓ REST + JSON ✓ Webhooks temps réel ✓ Rate limit 1000 req/min ✓ 99.99% uptime API
GET /api/v1/dossiers/DHQ-2026-047
{
  "id": "DHQ-2026-047",
  "titre": "Dégât d'eau — apt 4",
  "statut": "resolu",
  "priorite": "urgente",
  "entite": {
    "type": "logement",
    "adresse": "302 Laurier Est, apt 4"
  },
  "assigne_a": "[email protected]",
  "messages": 12,
  "documents": 8,
  "cree_le": "2026-05-28T09:12:00Z",
  "resolu_le": "2026-05-30T17:00:00Z"
}
REST API standard, prévisible, documentée
< 50ms latence moyenne des endpoints
50+ intégrations natives disponibles
5 min pour votre première intégration
Endpoints

Une API complète et cohérente

CRUD complet sur toutes les ressources. Pagination, filtres, tri, recherche full-text. Tout ce dont vous avez besoin pour construire des intégrations robustes.

📂 Dossiers

GET /api/v1/dossiers Lister les dossiers (filtres, pagination)
GET /api/v1/dossiers/{id} Détail d'un dossier
POST /api/v1/dossiers Créer un dossier
PATCH /api/v1/dossiers/{id} Modifier un dossier
DEL /api/v1/dossiers/{id} Archiver un dossier

💬 Messages

GET /api/v1/dossiers/{id}/messages Chronologie du dossier
POST /api/v1/dossiers/{id}/messages Ajouter un message
POST /api/v1/dossiers/{id}/notes Ajouter une note interne

📄 Documents

GET /api/v1/dossiers/{id}/documents Lister les documents
POST /api/v1/dossiers/{id}/documents Upload un document
GET /api/v1/documents/{id}/download Télécharger un fichier

🔔 Webhooks

GET /api/v1/webhooks Lister les webhooks configurés
POST /api/v1/webhooks Créer un webhook
POST /api/v1/webhooks/{id}/test Tester un webhook
🔔 Webhooks

Réagissez en temps réel

Recevez une notification instantanée quand quelque chose se passe dans DossierHQ. Pas de polling — du push pur.

📥

dossier.created

Un nouveau dossier est créé. Recevez l'objet complet avec toutes les métadonnées pour déclencher vos propres automatisations.

🔄

dossier.updated

Statut, priorité, assignation ou tout champ modifié. Le payload inclut les valeurs avant/après pour un diff précis.

💬

message.received

Un nouveau message arrive (email, SMS, portail). Idéal pour déclencher des notifications dans Slack ou Teams.

📄

document.uploaded

Un document est ajouté à un dossier. Déclenchez un scan antivirus, une extraction OCR ou un archivage externe.

⏰

sla.warning

Un SLA approche de son échéance (75%, 90%, 100%). Déclenchez une escalade dans votre outil de monitoring.

✅

dossier.resolved

Un dossier est marqué résolu. Déclenchez un sondage de satisfaction, une facturation ou un archivage.

Intégrations

Connecté à vos outils existants

Intégrations natives en un clic. Pas besoin de développeur — activez, configurez, c'est fait.

📧

Email (IMAP/SMTP)

Connectez n'importe quelle boîte email. Les messages entrants créent ou alimentent des dossiers automatiquement.

📱

SMS (Twilio)

Envoyez et recevez des SMS directement depuis les dossiers. Historique complet dans la chronologie.

💬

Slack / Teams

Notifications dans vos canaux. Créez des dossiers depuis Slack. Répondez sans quitter votre messagerie.

📁

Google Drive / OneDrive

Synchronisez les documents. Les fichiers ajoutés dans un dossier partagé apparaissent dans DossierHQ.

🔑

SSO (SAML / OAuth)

Azure AD, Google Workspace, Okta, OneLogin. Connexion unique pour toute votre organisation.

💰

Comptabilité

QuickBooks, Xero, Wave. Liez les factures aux dossiers. Facturation automatique à la résolution.

📊

Monitoring (Zabbix, PRTG)

Les alertes monitoring créent des dossiers automatiquement. Corrélation multi-alertes en un seul dossier.

🔗

Zapier / Make

Connectez DossierHQ à 5000+ applications via Zapier ou Make. Sans code, en quelques clics.

❓ FAQ

Questions fréquentes sur l'API

1000 requêtes par minute par clé API (plan Pro). 5000/min pour Enterprise. Les headers de réponse incluent X-RateLimit-Remaining pour que vous puissiez adapter votre débit. En cas de dépassement, vous recevez un 429 avec un Retry-After.

Oui. L'URL inclut la version (/api/v1/). Nous garantissons la rétrocompatibilité pendant 24 mois minimum après la sortie d'une nouvelle version. Les breaking changes sont annoncés 6 mois à l'avance.

Bearer token dans le header Authorization. Les tokens sont générés dans l'admin avec des permissions granulaires (lecture seule, écriture, admin). Vous pouvez créer plusieurs tokens avec des portées différentes pour chaque intégration.

Oui. SDK officiels en PHP, JavaScript/TypeScript, Python et C#. Disponibles sur Packagist, npm, PyPI et NuGet. Chaque SDK inclut le typage complet, la gestion des erreurs et la pagination automatique.

Prêt à centraliser vos dossiers?

Essayez DossierHQ gratuitement pendant 14 jours. Aucune carte de crédit requise.