Connecter une application à QuotyFast

Avant de commencer

L'API et les webhooks sont inclus à partir du plan Premium ; le plan Starter ne les inclut pas. Les plans supérieurs n'ajoutent que du volume : plus de requêtes par minute et par jour.

Ouvrez « Paramètres », onglet « API & Webhooks ». L'onglet est réservé au propriétaire de l'organisation. Le lien « Documentation de l'API » y ouvre la documentation technique.

• L'API QuotyFast : ce qu'elle permet et les quotas par plan
• Documentation technique de l'API

Créer une clé

1. 1Dans « Clés d'API », cliquez sur « Créer une clé ».
2. 2À « Où allez-vous utiliser cette clé ? », choisissez « Sur mon serveur » : l'application appelle QuotyFast depuis son serveur, et la clé y reste secrète.
3. 3Donnez-lui un « Nom », celui de l'application qui l'utilisera.
4. 4Cochez les « Permissions » nécessaires, voir ci-dessous.
5. 5Cliquez sur « Créer la clé ».

« Votre clé » ne s'affiche qu'une fois : cliquez sur « Copier la clé » tout de suite. Le serveur n'en garde qu'une empreinte ; une clé perdue se remplace par une nouvelle. La commande « Tester sans rien créer » passe tous les contrôles sans rien enregistrer.

Choisir les permissions

Une clé n'ouvre que les permissions cochées : ne cochez que ce dont l'application a besoin.

Clients : « Lire les clients », « Créer et modifier des clients ». Devis : « Lire les devis », « Créer et envoyer des devis ». Factures : « Lire les factures », « Émettre et envoyer des factures ». Webhooks : « Gérer les webhooks », pour que l'application enregistre elle-même ses webhooks.

Les permissions qui créent ou modifient des clients, des devis ou des factures, et « Gérer les webhooks », sont réservées aux clés utilisées « Sur mon serveur ».

Ajouter un webhook

1. 1Dans « Webhooks sortants », cliquez sur « Ajouter un webhook ».
2. 2Saisissez l'« URL de destination » : https uniquement, sans identifiants dans l'adresse.
3. 3Cochez les « Événements » à recevoir : client.created, quote.created, quote.accepted, quote.refused, invoice.issued, credit_note.issued, invoice.paid. Un événement marqué « Réservé » n'est encore émis par aucun module.
4. 4Cliquez sur « Créer le webhook ».

Le « Secret de signature » ne s'affiche qu'une fois : cliquez sur « Copier le secret ». Chaque envoi porte l'en-tête X-QuotyFast-Signature (sha256= suivi du HMAC-SHA256 du corps) et, contre le rejeu, X-QuotyFast-Signature-V2 avec X-QuotyFast-Timestamp. Vérifiez la signature à la réception. « Nouveau secret » en génère un autre.

Lire les livraisons

Sur la carte d'un webhook, « Livraisons » ouvre les « Dernières livraisons » : l'« Événement », le « Statut » — « En attente », « Livré » ou « Échec » —, les « Tentatives », la « Date » et le « Détail » d'une erreur. Le contenu envoyé n'est pas réaffiché.

« Désactiver » arrête les envois d'un webhook, « Activer » les relance. Après une série d'échecs consécutifs, QuotyFast le désactive automatiquement et l'indique sur la carte.

« Consommation de l'API aujourd'hui » montre les « Requêtes du jour » et les « Écritures du jour (clients, devis, factures) » face aux quotas de votre plan. Le compteur repart à zéro à minuit, heure de Bruxelles.

Régénérer, révoquer ou réactiver une clé

Chaque clé affiche sa « Dernière utilisation » et son « Dernier refus », avec la raison.

« Régénérer » crée une nouvelle valeur : l'ancienne est refusée dès le prochain appel. Mettez à jour l'application qui l'utilise. « Révoquer » coupe la clé : tout appel qui l'utilise est refusé immédiatement.

Une clé est « Suspendue » quand la personne qui l'a créée ne fait plus partie de l'organisation : tous ses appels sont refusés. Seul le propriétaire la remet en service, avec « Réactiver » ; une clé suspendue se réactive avant de pouvoir être régénérée.