Dokumentation
Die Dotwick-API
REST über JSON. Erstellen Sie einen Code, ändern Sie sein Ziel, erhalten Sie einen signierten Webhook, wenn jemand scannt. Die Referenz unten wird aus denselben Verträgen erzeugt, mit denen die API validiert. Ein SDK brauchen Sie nicht: Jedes Beispiel ist curl, JavaScript oder Python.
Erste Schritte
Erste SchritteSchnellstartDrei Schritte: Schlüssel in der App erstellen, einen Code erstellen und den zurückgegebenen Kurzlink scannen.Erste SchritteAuthentifizierungSenden Sie Ihren geheimen Schlüssel als Bearer-Token. Schlüssel tragen Scopes und handeln mit der Rolle ihres Erstellers in einem Arbeitsbereich, begrenzt auf Editor.Erste SchritteFehlerFehler sind JSON mit einem stabilen Code zum Verzweigen, einer lesbaren Meldung und einer Request-ID für den Support.
Codes
Codes / Code erstellenCode erstellenErstellt einen Code und gibt ihn mit seinem Kurzlink zurück. Das Ziel eines dynamischen Codes lässt sich später per PATCH ändern, ohne den gedruckten Code anzufassen.Codes / Codes auflistenCodes auflistenListet die Codes, die der Schlüssel sehen kann, neueste zuerst, jeweils eine Seite. Filtern Sie nach Ordner, Typ, Status oder Suchbegriff.Codes / Code aktualisierenCode aktualisierenÄndert Ziel, Namen, Design, Regeln, Ordner oder Status eines Codes. Der Kurzlink und jede gedruckte Kopie funktionieren weiter – nur das Ziel ändert sich.Codes / MassenerstellungMassenerstellungErstellt bis zu 500 Codes eines Typs in einer Anfrage, als Hintergrundlauf, den Sie verfolgen können – dieselben Läufe wie bei einem CSV-Upload in der App.
Statistiken
Webhooks
Webhooks / Endpunkt registrierenEndpunkt registrierenRegistrieren Sie einen https-Endpunkt und wählen Sie die Ereignisse. Wir senden jedes Ereignis signiert per POST als JSON und wiederholen es, bis 2xx antwortet.Webhooks / EreignistypenEreignistypenJedes Ereignis nutzt denselben Umschlag. data enthält dieselben Objekte, die die API zurückgibt, ein Parser genügt also für beides.Webhooks / Signaturen prüfenSignaturen prüfenZustellungen werden nach der Standard-Webhooks-Spezifikation signiert. Prüfen Sie die Signatur, bevor Sie einer Nutzlast vertrauen.
Conversions
ConversionsConversion-PixelZählen Sie Besuche und Bestellungen nach einem Scan. Ein kleines Skript speichert die Klick-ID und meldet Ihr Ziel, mit Einwilligung und ohne personenbezogene Daten.ConversionsServer-MeldungMelden Sie eine Conversion von Ihrem Server, wenn die Bestellung bestätigt ist oder das Pixel nie geladen wurde. Senden Sie Klick-ID, Ereignis und optional einen Wert.
Integrationen
IntegrationenZapierSenden Sie Scans, Formularantworten und neue Codes an Zapier-Apps und erstellen oder ändern Sie Codes aus einem Zap. Die Dotwick-App für Zapier nutzt einen API-Schlüssel.IntegrationenMakeStarten Sie Make-Szenarien bei Scans, Formularantworten und neuen Codes und erstellen oder ändern Sie Codes darin. Die Dotwick-App für Make nutzt einen API-Schlüssel.IntegrationenShopifySehen Sie den Umsatz, den jeder QR-Code Ihrem Shopify-Shop bringt. Die App liest Bestellsummen und die Klick-ID, nie, wer kauft. Eintrag kommt bald.IntegrationenSlackSenden Sie Scan-Alarme und eine Wochenübersicht in einen Slack-Kanal und erstellen oder prüfen Sie Codes mit /dotwick. Der Slack-Eintrag kommt bald.IntegrationenHubSpot und SalesforceLegen Sie aus Formularantworten und Visitenkarten Kontakte in HubSpot und Leads in Salesforce an und sehen Sie Scans eines Codes in der Zeitleiste. Einträge kommen bald.
Visitenkarten
Apps
AppsMobile AppVerwalten Sie Ihre Codes vom Smartphone aus: scannen, erstellen, Scans ansehen und die eigene Visitenkarte zeigen. Die Apps für iOS und Android kommen bald.AppsChrome-ErweiterungErstellen Sie aus dem Browser einen QR-Code für die Seite, auf der Sie gerade sind. Die Erweiterung kommt bald in den Chrome Web Store.
KI-Assistenten
Referenz
ReferenzAPI-ReferenzJede Route, die ein API-Schlüssel aufrufen kann, mit Scope. Basis-URL https://api.dotwick.com, OpenAPI-Dokument unter https://api.dotwick.com/openapi.json.ReferenzRatenbegrenzungenDie Limits gelten pro Arbeitsbereich, werden von allen API-Schlüsseln darin geteilt und wachsen mit dem Tarif.ReferenzPaginierungListen sind Cursor-paginiert: { data, nextCursor }, neueste zuerst, sofern keine Sortierung etwas anderes sagt.ReferenzIdempotenzSenden Sie einen Idempotency-Key mit einem POST, und ein erneuter Versuch kann die Arbeit nie doppelt ausführen.ReferenzVersionierungEine Version, v1, unter /v1. Sie wächst nur; nichts darin ändert sich oder verschwindet ohne ein Jahr Vorankündigung.ReferenzÄnderungsprotokollJede Ergänzung und jede Abkündigung der API, neueste zuerst. Deprecation-Header verlinken hierher.