Docs
API Dotwick
REST na JSON. Utwórz kod, zmień, dokąd prowadzi, i odbierz podpisany webhook, gdy ktoś go zeskanuje. Poniższa dokumentacja jest generowana z tych samych kontraktów, którymi API waliduje dane. SDK niepotrzebne: każdy przykład to curl, JavaScript lub Python.
Pierwsze kroki
Pierwsze krokiSzybki startTrzy kroki: utwórz klucz w aplikacji, utwórz kod i zeskanuj zwrócony krótki link.Pierwsze krokiUwierzytelnianieWysyłaj swój klucz tajny jako token bearer. Klucze mają zakresy i działają z rolą swojego twórcy w jednym obszarze roboczym, maksymalnie jako Editor.Pierwsze krokiBłędyBłędy to JSON ze stabilnym kodem, według którego można rozgałęziać, czytelnym komunikatem i identyfikatorem żądania dla pomocy.
Kody
Kody / Utwórz kodUtwórz kodTworzy kod i zwraca go z krótkim linkiem. Adres docelowy kodu dynamicznego można później zmienić przez PATCH bez dotykania wydrukowanego kodu.Kody / Wyświetl kodyWyświetl kodyZwraca kody, które klucz może widzieć, od najnowszych, po jednej stronie. Filtruj według folderu, typu, statusu lub frazy.Kody / Zaktualizuj kodZaktualizuj kodZmienia adres docelowy, nazwę, projekt, reguły, folder lub status kodu. Krótki link i każda wydrukowana kopia nadal działają: zmienia się tylko cel.Kody / Tworzenie zbiorczeTworzenie zbiorczeTworzy do 500 kodów jednego typu jednym żądaniem, jako uruchomienie w tle, które możesz śledzić: te same uruchomienia co przy wgraniu CSV w aplikacji.
Statystyki
Webhooki
Webhooki / Zarejestruj endpointZarejestruj endpointZarejestruj endpoint https i wybierz zdarzenia. Wysyłamy każde zdarzenie metodą POST jako podpisany JSON i ponawiamy aż do odpowiedzi 2xx.Webhooki / Typy zdarzeńTypy zdarzeńKażde zdarzenie ma tę samą kopertę. data zawiera te same obiekty, które zwraca API, więc jeden parser obsłuży oba.Webhooki / Weryfikacja podpisówWeryfikacja podpisówDostawy są podpisywane zgodnie ze specyfikacją Standard Webhooks. Sprawdź podpis, zanim zaufasz payloadowi.
Konwersje
KonwersjePiksel konwersjiZliczaj wizyty i zamówienia po skanie. Mały skrypt na Twojej stronie zachowuje identyfikator kliknięcia i zgłasza cel, po zgodzie i bez danych osobowych.KonwersjePostback z serweraZgłoś konwersję z własnego serwera, gdy zamówienie jest potwierdzone lub piksel się nie załadował. Wysyłasz identyfikator kliknięcia, zdarzenie i ewentualnie wartość.
Integracje
IntegracjeZapierWysyłaj skany, odpowiedzi z formularzy i nowe kody do aplikacji Zapier oraz twórz lub zmieniaj kody ze Zapa. Aplikacja Dotwick dla Zapier używa klucza API.IntegracjeMakeUruchamiaj scenariusze Make na skanach, formularzach i nowych kodach oraz twórz lub zmieniaj kody ze scenariusza. Aplikacja Dotwick dla Make używa klucza API.IntegracjeShopifyZobacz przychody, które każdy kod QR przynosi Twojemu sklepowi Shopify. Aplikacja czyta sumy zamówień i identyfikator kliknięcia, nigdy klienta. Oferta wkrótce.IntegracjeSlackWysyłaj alerty o skanach i cotygodniowe podsumowanie na kanał Slacka oraz twórz lub sprawdzaj kody przez /dotwick. Oferta w Slacku pojawi się wkrótce.IntegracjeHubSpot i SalesforceTwórz kontakty w HubSpot i leady w Salesforce z formularzy i wizytówek oraz zobacz skany kodu na osi czasu rekordu. Obie oferty pojawią się wkrótce.
Wizytówki
Aplikacje
AplikacjeAplikacja mobilnaZarządzaj kodami z telefonu: skanuj, twórz, sprawdzaj skany i pokazuj własną wizytówkę. Aplikacje na iOS i Androida pojawią się wkrótce.AplikacjeRozszerzenie ChromeUtwórz kod QR dla strony, na której jesteś, z poziomu przeglądarki. Rozszerzenie pojawi się wkrótce w Chrome Web Store.
Asystenci AI
Dokumentacja
DokumentacjaDokumentacja APIKażda trasa, którą może wywołać klucz API, wraz z zakresem. Adres bazowy https://api.dotwick.com, dokument OpenAPI pod https://api.dotwick.com/openapi.json.DokumentacjaLimity zapytańLimity obowiązują na obszar roboczy, są wspólne dla każdego klucza API w nim i rosną wraz z planem.DokumentacjaPaginacjaListy są stronicowane kursorem: { data, nextCursor }, od najnowszych, chyba że sortowanie mówi inaczej.DokumentacjaIdempotentnośćWyślij Idempotency-Key z POST, a ponowienie nigdy nie wykona pracy dwa razy.DokumentacjaWersjonowanieJedna wersja, v1, pod /v1. Tylko rośnie; nic w niej nie zmienia się ani nie znika bez rocznego uprzedzenia.DokumentacjaChangelogKażde dodanie i każde wycofanie API, od najnowszych. Nagłówki wycofania prowadzą tutaj.