Documentation
L’API Dotwick
REST sur JSON. Créez un code, changez sa destination, recevez un webhook signé quand quelqu’un le scanne. La référence ci-dessous est générée à partir des mêmes contrats que ceux avec lesquels l’API valide les requêtes. Aucun SDK nécessaire : chaque exemple est en curl, JavaScript ou Python.
Prise en main
Prise en mainDémarrage rapideTrois étapes : créez une clé dans l’application, créez un code et scannez le lien court qu’elle renvoie.Prise en mainAuthentificationEnvoyez votre clé secrète comme jeton bearer. Les clés portent des scopes et agissent avec le rôle de leur créateur dans un espace de travail, plafonné à Editor.Prise en mainErreursLes erreurs sont du JSON avec un code stable sur lequel brancher votre logique, un message lisible et un identifiant de requête pour le support.
Codes
Codes / Créer un codeCréer un codeCrée un code et le renvoie avec son lien court. La destination d’un code dynamique peut être modifiée plus tard avec PATCH sans toucher au code imprimé.Codes / Lister les codesLister les codesListe les codes que la clé peut voir, du plus récent au plus ancien, une page à la fois. Filtrez par dossier, type, statut ou terme de recherche.Codes / Modifier un codeModifier un codeModifie la destination, le nom, le design, les règles, le dossier ou le statut d’un code. Lien court et codes imprimés restent valides : seule la destination change.Codes / Création en masseCréation en masseCrée jusqu’à 500 codes d’un même type en une requête, sous forme d’une série en arrière-plan que vous suivez, comme un import CSV dans l’application.
Statistiques
Webhooks
Webhooks / Enregistrer un endpointEnregistrer un endpointEnregistrez un endpoint https et choisissez les événements. Nous envoyons chaque événement en POST au format JSON, signé, et réessayons jusqu’à une réponse 2xx.Webhooks / Types d’événementsTypes d’événementsTous les événements partagent la même enveloppe. data contient les mêmes objets que ceux renvoyés par l’API : un seul analyseur suffit pour les deux.Webhooks / Vérifier les signaturesVérifier les signaturesLes envois sont signés selon la spécification Standard Webhooks. Vérifiez la signature avant de faire confiance à un contenu.
Conversions
ConversionsPixel de conversionComptez visites et commandes après un scan. Un petit script garde l’identifiant de clic et signale votre objectif, avec consentement et sans donnée personnelle.ConversionsEnvoi depuis le serveurSignalez une conversion depuis votre serveur quand la commande est confirmée ou que le pixel n’a pas chargé. Envoyez l’identifiant de clic, l’événement et une valeur.
Intégrations
IntégrationsZapierEnvoyez scans, formulaires et nouveaux codes vers vos applications Zapier, et gérez vos codes depuis un Zap. L’application Dotwick pour Zapier utilise une clé d’API.IntégrationsMakeLancez des scénarios Make sur les scans, formulaires et nouveaux codes, et gérez vos codes depuis un scénario. L’application Dotwick pour Make utilise une clé d’API.IntégrationsShopifyVoyez le chiffre d’affaires que chaque QR code apporte à votre boutique Shopify. L’application lit les totaux et l’identifiant de clic, jamais le client. Fiche bientôt.IntégrationsSlackEnvoyez les alertes de scan et un récapitulatif hebdomadaire dans un canal Slack, et créez ou consultez des codes avec /dotwick. La fiche Slack arrive bientôt.IntégrationsHubSpot et SalesforceCréez des contacts HubSpot et des prospects Salesforce depuis les formulaires et cartes de visite, et voyez les scans d’un code dans la chronologie. Bientôt disponible.
Cartes de visite
Applications
ApplicationsApplication mobileGérez vos codes depuis votre téléphone : scanner, créer, consulter les scans et montrer votre propre carte de visite. Les applications iOS et Android arrivent bientôt.ApplicationsExtension ChromeCréez un QR code de la page où vous êtes, depuis votre navigateur. L’extension arrive bientôt sur le Chrome Web Store.
Assistants IA
Référence
RéférenceRéférence de l’APIToutes les routes qu’une clé d’API peut appeler, avec leur scope. URL de base https://api.dotwick.com, document OpenAPI : https://api.dotwick.com/openapi.json.RéférenceLimites de débitLes limites s’appliquent par espace de travail, partagées par toutes les clés d’API qu’il contient, et évoluent avec l’offre.RéférencePaginationLes listes sont paginées par curseur : { data, nextCursor }, du plus récent au plus ancien sauf si un tri indique autre chose.RéférenceIdempotenceEnvoyez un Idempotency-Key avec un POST et le réessayer ne peut jamais faire le travail deux fois.RéférenceVersionsUne seule version, v1, sous /v1. Elle ne fait que s’enrichir ; rien n’y change ni n’y disparaît sans un an de préavis.RéférenceJournal des modificationsChaque ajout et chaque dépréciation de l’API, du plus récent au plus ancien. Les en-têtes de dépréciation renvoient ici.