Une API REST JSON versionnée, sécurisée par authentification à clé unique. Abonnez-vous aux webhooks de 12 événements couvrant interventions, factures, paiements, devis et clients. Disponible dans l'offre Scale.
curl https://api.servicesynchq.com/api/v1/jobs \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customerId": 12345,
"scheduledDate": "2026-08-20T14:00:00Z",
"title": "HVAC repair"
}'{ "id": 84213, "customerId": 12345, "status": "scheduled", "scheduledDate": "2026-08-20T14:00:00Z", "title": "HVAC repair", "createdAt": "2026-07-24T08:14:22Z"}Un aperçu de la surface exposée. Clients, interventions, factures, devis, paiements, inventaire, planification et notifications exposent tous un CRUD complet en JSON.
CRUD complet en JSON, sécurisé par votre X-API-Key.
Enregistrez un endpoint et réagissez en temps réel.
Deux façons d'intégrer — REST pour la lecture/écriture, webhooks pour le push en temps réel.
/api/v1/customers
Lister tous les clients.
pagination par curseur/api/v1/customers
Créez un nouveau client.
idempotency-key pris en charge/api/v1/jobs
Listez les interventions filtrées par statut ou par date.
triable + filtrable/api/v1/jobs
Planifiez une nouvelle intervention. Déclenche job.created webhook.
/api/v1/invoices
Lister les factures avec pagination.
adapté à la juridiction/api/v1/invoices/:id/send
Envoyez la facture par e-mail ou SMS. IRN généré automatiquement pour l'Inde.
adossé à une file de relanceUn échantillon représentatif couvrant clients · interventions · devis · factures · paiements · stock · achats · planification · notifications. Chaque appel privilégié est consigné dans le journal d'audit. Voir la référence complète →
Transmettez un code pays et obtenez le bon calcul de taxes, la bonne mise en page de document, la bonne charge utile de facture électronique. Mêmes endpoints, comportement adapté à chaque juridiction — aucune ramification par pays dans votre code d'intégration.
Indiquez votre intention — nous calculons la bonne ventilation des taxes. Changements d'État, changements d'immatriculation, bascules de juridiction : ce sont des données, pas du code. Isolation de niveau bancaire : les données de chaque client résident dans leur propre coffre logique — la base de données elle-même refuse de mélanger les données entre coffres, et pas seulement le code applicatif.
Fournisseur et client dans le même État ? CGST + SGST. Différent ? IGST. Calculé à partir de company.state vs customer.state.
Génère l'IRN + un QR signé lors du POST. 24h cancellation window exposé via un point de terminaison dédié. Codes HSN par recherche.
Déduit automatiquement 20% / 30% / 0% selon le statut d'immatriculation du prestataire, pour chaque sous-traitant.
Facture bilingue Phase 1 + QR TLV encodant l'ensemble des 5 mandatory tags. Validé auprès de ZATCA avant le rendu.
Chaque requête est authentifiée par une clé API envoyée dans l'en-tête
X-API-Key en-tête. Les clés sont créées par les administrateurs de votre espace,
révocables à tout moment, et chaque appel privilégié est consigné dans le journal d'audit.
Les clés sont affichées une seule fois à la création et stockées uniquement sous forme de hachage — jamais en clair.
X-API-Key en-tête à chaque requête.
curl https://api.servicesynchq.com/api/v1/customers \
-H "X-API-Key: YOUR_API_KEY"
# 200 OK — returns your customers as JSON.
# Manage keys under Settings → API keys (admin only).Abonnez-vous aux événements de cycle de vie couvrant CRM, répartition, facturation, paiements, achats et audit. Chaque webhook est signé cryptographiquement, réémis avec un backoff exponentiel et adossé à une file de reprise durable.
job.created
Nouvelle intervention créée.
job.completed
Intervention marquée comme terminée.
job.status_changed
Une intervention est passée à un nouveau statut.
invoice.created
Nouvelle facture créée.
invoice.paid
Paiement de facture reçu.
invoice.overdue
La facture a dépassé son échéance sans être payée.
payment.received
Un paiement client a été enregistré.
customer.created
Nouveau client ajouté.
estimate.sent
Devis envoyé au client.
estimate.accepted
Le client a accepté le devis.
estimate.rejected
Le client a refusé le devis.
estimate.converted_to_job
Devis accepté converti en intervention.
Des SDK officiels sont en cours de développement. En attendant leur sortie, l'API REST est entièrement documentée ci-dessus et fonctionne avec n'importe quel client HTTP.
Chaque requête est automatiquement limitée à votre espace de travail au niveau de la couche base de données — pas seulement dans le code applicatif. Une requête d'un espace de travail ne peut littéralement pas lire les données d'un autre espace de travail — c'est la base de données elle-même qui l'impose.
Des limites de débit à usage raisonnable avec capacité de rafale. Votre limite actuelle et votre quota restant
sont renvoyés à chaque réponse dans X-RateLimit-Limit / X-RateLimit-Remaining /
X-RateLimit-Reset en-têtes (brouillon de norme IETF). Vous n'aurez jamais à deviner ce qui est autorisé.
Une marge suffisante pour les intégrations ordinaires · les en-têtes vous indiquent en temps réel
Pour la synchronisation à haut débit, l'export en masse et les charges ETL
Contacter le service commercial pour le dimensionnement
429 Too Many Requests avec un Retry-After en-tête en quelques secondes.
Nos SDK gèrent cela automatiquement avec un backoff exponentiel.
Si vous avez régulièrement besoin de plafonds plus élevés, parlons-en
— les chiffres publiés sont des planchers, pas des plafonds.
Nous protégeons vos clés comme nous voudrions que les nôtres le soient. Voici ce sur quoi vous pouvez compter.
Documentation de référence, journal des modifications et une vraie personne au bout du fil quand vous êtes bloqué.
Chaque endpoint, chaque paramètre, chaque format de réponse — avec des exemples prêts à copier-coller.
Versions de l'API, avis de dépréciation et guides de migration.
Ligne directe avec l'équipe d'ingénierie. Réponse sous un jour ouvré avec l'offre Scale.
L'accès API est inclus dans l'offre Scale. Consultez d'abord la documentation, récupérez vos clés quand vous êtes prêt.