Docs
L’API di Dotwick
REST su JSON. Crea un codice, cambia dove porta, ricevi un webhook firmato quando qualcuno lo scansiona. Il riferimento qui sotto è generato dagli stessi contratti con cui l’API valida. Nessun SDK necessario: ogni esempio è in curl, JavaScript o Python.
Per iniziare
Per iniziareGuida rapidaTre passi: crea una chiave nell’app, crea un codice e scansiona il link breve che restituisce.Per iniziareAutenticazioneInvia la tua chiave segreta come bearer token. Le chiavi hanno ambiti e agiscono con il ruolo del loro creatore in un solo spazio di lavoro, al massimo come Editor.Per iniziareErroriGli errori sono JSON con un codice stabile su cui ramificare, un messaggio leggibile e un ID richiesta per l’assistenza.
Codici
Codici / Crea un codiceCrea un codiceCrea un codice e lo restituisce con il suo link breve. La destinazione di un codice dinamico si può cambiare poi con PATCH senza toccare il codice stampato.Codici / Elenca i codiciElenca i codiciElenca i codici che la chiave può vedere, i più recenti per primi, una pagina alla volta. Filtra per cartella, tipo, stato o termine di ricerca.Codici / Aggiorna un codiceAggiorna un codiceCambia destinazione, nome, design, regole, cartella o stato di un codice. Il link breve e ogni copia stampata continuano a funzionare: cambia solo dove puntano.Codici / Creazione in bloccoCreazione in bloccoCrea fino a 500 codici di un tipo in una sola richiesta, come esecuzione in background che puoi seguire: le stesse esecuzioni di un caricamento CSV nell’app.
Statistiche
Webhook
Webhook / Registra un endpointRegistra un endpointRegistra un endpoint https e scegli gli eventi. Inviamo ogni evento con POST come JSON firmato e riproviamo finché non risponde 2xx.Webhook / Tipi di eventoTipi di eventoOgni evento condivide un solo envelope. data contiene gli stessi oggetti che restituisce l’API, quindi un solo parser serve per entrambi.Webhook / Verifica delle firmeVerifica delle firmeLe consegne sono firmate secondo la specifica Standard Webhooks. Controlla la firma prima di fidarti di un payload.
Conversioni
ConversioniPixel di conversioneConta visite e ordini dopo una scansione. Un piccolo script sul tuo sito conserva l’ID clic e segnala il tuo obiettivo, con consenso e senza dati personali.ConversioniPostback dal serverSegnala una conversione dal tuo server quando l’ordine è confermato o il pixel non è stato caricato. Invii l’ID clic, l’evento e, se c’è, un valore.
Integrazioni
IntegrazioniZapierInvia scansioni, risposte dei moduli e nuovi codici alle app di Zapier e crea o cambia codici da uno Zap. L’app Dotwick per Zapier usa una chiave API.IntegrazioniMakeEsegui scenari Make su scansioni, risposte dei moduli e nuovi codici e crea o cambia codici da uno scenario. L’app Dotwick per Make usa una chiave API.IntegrazioniShopifyVedi i ricavi che ogni codice QR porta al tuo negozio Shopify. L’app legge i totali degli ordini e l’ID clic, mai chi è il cliente. Scheda in arrivo.IntegrazioniSlackInvia avvisi di scansione e un riepilogo settimanale a un canale Slack, e crea o controlla codici con /dotwick. La scheda su Slack è in arrivo.IntegrazioniHubSpot e SalesforceCrea contatti in HubSpot e lead in Salesforce da moduli e biglietti da visita, e vedi le scansioni di un codice nella cronologia del record. Schede in arrivo.
Biglietti da visita
App
AppApp mobileGestisci i tuoi codici dal telefono: scansiona, crea, controlla le scansioni e mostra il tuo biglietto da visita. Le app per iOS e Android sono in arrivo.AppEstensione ChromeCrea un codice QR per la pagina che stai guardando, dal browser. L’estensione arriva presto sul Chrome Web Store.
Assistenti IA
Riferimento
RiferimentoRiferimento APIOgni route che una chiave API può chiamare, con l’ambito necessario. URL di base https://api.dotwick.com, documento OpenAPI in https://api.dotwick.com/openapi.json.RiferimentoLimiti di richiesteI limiti sono per spazio di lavoro, condivisi da ogni chiave API al suo interno, e scalano con il piano.RiferimentoPaginazioneGli elenchi sono paginati a cursore: { data, nextCursor }, i più recenti per primi salvo diverso ordinamento.RiferimentoIdempotenzaInvia un Idempotency-Key con un POST e ritentarlo non potrà mai fare il lavoro due volte.RiferimentoVersioniUna sola versione, v1, sotto /v1. Cresce soltanto; nulla cambia o sparisce senza un anno di preavviso.RiferimentoChangelogOgni aggiunta e ogni deprecazione dell’API, le più recenti per prime. Le intestazioni di deprecazione rimandano qui.