Naar de inhoud
DOTWICK

Docs

De Dotwick-API

REST over JSON. Maak een code, wijzig waar hij heen gaat en ontvang een ondertekende webhook als iemand hem scant. De referentie hieronder wordt gegenereerd uit dezelfde contracten waarmee de API valideert. Geen SDK nodig: elk voorbeeld is curl, JavaScript of Python.

Aan de slag

Aan de slagSnelstartDrie stappen: maak een sleutel in de app, maak een code en scan de korte link die terugkomt.Aan de slagAuthenticatieStuur je geheime sleutel als bearer-token mee. Sleutels hebben scopes en handelen met de rol van hun maker in één werkruimte, begrensd op Editor.Aan de slagFoutenFouten zijn JSON met een stabiele code om op te vertakken, een leesbaar bericht en een verzoek-id voor support.

Codes

Codes / Een code makenEen code makenMaakt een code en geeft hem terug met zijn korte link. De bestemming van een dynamische code kun je later met PATCH wijzigen zonder de gedrukte code aan te raken.Codes / Codes weergevenCodes weergevenToont de codes die de sleutel kan zien, nieuwste eerst, een pagina tegelijk. Filter op map, type, status of zoekterm.Codes / Een code bijwerkenEen code bijwerkenWijzigt de bestemming, naam, ontwerp, regels, map of status van een code. De korte link en elke gedrukte kopie blijven werken: alleen waar ze heen wijzen verandert.Codes / Bulk aanmakenBulk aanmakenMaakt tot 500 codes van één type in één verzoek, als achtergrondrun die je kunt volgen: dezelfde runs als een CSV-upload in de app.

Analyse

AnalyseVergelijken en exporterenZet tot 4 codes naast elkaar over dezelfde periode en download scans als CSV-bestand. Beide vragen een sleutel met analytics:read.

Webhooks

Webhooks / Een endpoint registrerenEen endpoint registrerenRegistreer een https-endpoint en kies de gebeurtenissen. We sturen elke gebeurtenis ondertekend als JSON per POST en proberen opnieuw tot 2xx terugkomt.Webhooks / GebeurtenistypenGebeurtenistypenElke gebeurtenis deelt één envelop. data bevat dezelfde objecten die de API teruggeeft, dus één parser volstaat voor beide.Webhooks / Handtekeningen verifiërenHandtekeningen verifiërenLeveringen zijn ondertekend volgens de Standard Webhooks-specificatie. Controleer de handtekening voordat je een payload vertrouwt.

Conversies

ConversiesConversiepixelTel bezoeken en bestellingen na een scan. Een klein script op je website bewaart het klik-id en meldt je doel, met toestemming en zonder persoonsgegevens.ConversiesServer-postbackMeld een conversie vanaf je eigen server zodra de bestelling is bevestigd of de pixel niet laadde. Je stuurt het klik-id, de gebeurtenis en eventueel een waarde.

Integraties

IntegratiesZapierStuur scans, formulierantwoorden en nieuwe codes naar Zapier-apps en maak of wijzig codes vanuit een Zap. De Dotwick-app voor Zapier gebruikt een API-sleutel.IntegratiesMakeDraai Make-scenario’s op scans, formulierantwoorden en nieuwe codes en maak of wijzig codes vanuit een scenario. De Dotwick-app voor Make gebruikt een API-sleutel.IntegratiesShopifyZie de omzet die elke QR-code je Shopify-winkel oplevert. De app leest ordertotalen en het klik-id van een scan, nooit wie de klant is. Vermelding komt binnenkort.IntegratiesSlackStuur scanmeldingen en een wekelijks overzicht naar een Slack-kanaal, en maak of controleer codes met /dotwick. De Slack-vermelding komt binnenkort.IntegratiesHubSpot en SalesforceMaak contacten in HubSpot en leads in Salesforce uit formulierantwoorden en visitekaartjes, en zie de scans van een code op de tijdlijn. Vermeldingen komen binnenkort.

Visitekaartjes

VisitekaartjesSCIM-kaartsynchronisatieHoud elk teamvisitekaartje in de pas met je directory. Okta, Microsoft Entra ID en Google Workspace maken, wijzigen en deactiveren kaartjes via SCIM.

Apps

AppsMobiele appBeheer je codes vanaf je telefoon: scan, maak, bekijk scans en toon je eigen visitekaartje. De iOS- en Android-apps komen binnenkort.AppsChrome-extensieMaak een QR-code voor de pagina waarop je zit, vanuit je browser. De extensie komt binnenkort in de Chrome Web Store.

AI-assistenten

AI-assistentenMCP-serverKoppel Claude, ChatGPT of een codeeragent met een API-sleutel aan je Dotwick-werkruimte. Hij kan codes weergeven, maken, taggen en je scans lezen.

Referentie

ReferentieAPI-referentieElke route die een API-sleutel kan aanroepen, met de scope. Basis-URL https://api.dotwick.com, OpenAPI-document op https://api.dotwick.com/openapi.json.ReferentieAanvraaglimietenLimieten gelden per werkruimte, worden gedeeld door elke API-sleutel erin en schalen mee met het abonnement.ReferentiePagineringLijsten zijn met cursors gepagineerd: { data, nextCursor }, nieuwste eerst tenzij een sortering anders zegt.ReferentieIdempotentieStuur een Idempotency-Key mee met een POST en opnieuw proberen kan het werk nooit twee keer doen.ReferentieVersiebeheerEén versie, v1, onder /v1. Hij groeit alleen; niets erin verandert of verdwijnt zonder een jaar vooraf te waarschuwen.ReferentieChangelogElke toevoeging en elke afschaffing van de API, nieuwste eerst. Afschaffingsheaders linken hierheen.