Référence de l’API
Intégrez Dossiera à vos outils : lisez et écrivez vos clients, tâches, rendez-vous, demandes et documents via une API REST à jetons, gérée par le cabinet.
Aperçu de la v1 en préparation. Les chemins et les champs peuvent encore évoluer jusqu’à l’ouverture ; l’accès ouvrira après finalisation et revue des conditions. Écrivez-nous pour être prévenu.
Conventions
Les mêmes règles sur toute l’API.
URL de base
https://app.dossiera.ca/api/v1Authentification
Authorization: Bearer dsk_live_…Authentification
En-tête Authorization: Bearer avec un jeton dsk_live_ généré depuis vos réglages. Un jeton n’a jamais plus de droits que son rôle ; le périmètre du cabinet vient du jeton, jamais d’un paramètre.
Pagination par curseur
Les listes renvoient { data, meta: { next_cursor } }. Passez ?cursor= pour la page suivante et ?limit= pour la taille. Pas d’offset (il dérive quand des lignes s’insèrent).
Filtres
Cohérents entre ressources : ?client_id=, ?status=, ?updated_since=. updated_since permet de synchroniser sans tout relire.
Erreurs
Forme unique { error: { code, message, details } }. Le code est stable et lisible par machine (quota_exceeded, client_not_found) ; le message, localisé, peut changer.
Dates & montants
Dates en ISO 8601 UTC. Montants en cents entiers avec la devise — jamais de flottant sur de l’argent.
Idempotence
En-tête Idempotency-Key sur toutes les créations : rejouer la même clé renvoie la même ressource, sans doublon après un délai d’attente.
Limites de débit
300 requêtes/minute par jeton. En-têtes X-RateLimit-Limit/-Remaining/-Reset ; au-delà, 429 avec Retry-After.
Endpoints
La v1 couvre six ressources. On ajoute avec le temps — jamais de retrait ni de renommage dans une version publiée.
Clients
| GET | /v1/clients | Lister les clients (curseur ; filtres status, updated_since). |
| POST | /v1/clients | Créer un client. |
| GET | /v1/clients/{id} | Récupérer un client. |
| PATCH | /v1/clients/{id} | Mettre à jour un client. |
Tâches
| GET | /v1/tasks | Lister les tâches (filtres client_id, status, updated_since). |
| POST | /v1/tasks | Créer une tâche. |
| GET | /v1/tasks/{id} | Récupérer une tâche. |
| PATCH | /v1/tasks/{id} | Mettre à jour une tâche. |
| DELETE | /v1/tasks/{id} | Supprimer une tâche. |
Rendez-vous
| GET | /v1/appointments | Lister les rendez-vous. |
| POST | /v1/appointments | Créer un rendez-vous. |
| GET | /v1/appointments/{id} | Récupérer un rendez-vous. |
| POST | /v1/appointments/{id}/cancel | Annuler un rendez-vous. |
Demandes de documents
| GET | /v1/document-requests | Lister les demandes. |
| POST | /v1/document-requests | Créer une demande. |
| GET | /v1/document-requests/{id} | Récupérer une demande. |
| POST | /v1/document-requests/{id}/remind | Relancer le client (throttlé). |
Documents
| GET | /v1/documents | Lister les documents (métadonnées). |
| GET | /v1/documents/{id} | Récupérer les métadonnées d’un document. |
| POST | /v1/documents | Téléverser un document (consomme le quota de documents). |
Membres
| GET | /v1/members | Lister les membres du cabinet (lecture seule). |
Hors v1 par choix : OCR, rapprochement, push comptable et facturation. La référence complète sera générée depuis OpenAPI à l’ouverture.
Envie de brancher Dossiera à vos outils ?
Dites-nous ce que vous voulez intégrer — nous vous préviendrons dès l’ouverture.