Szybki start

1. Zdobądź klucz

W aplikacji otwórz Settings → API i wybierz New key. Wybierz zakresy potrzebne integracji (codes:read i codes:write wystarczą). Sekret zaczyna się od sk_live_ i jest pokazywany raz: przechowuj go w sekretach swojego serwera, nigdy w przeglądarce ani aplikacji mobilnej.

API jest w planach Pro, Business i Enterprise. Nie ma osobnego trybu testowego: do eksperymentów użyj drugiego obszaru roboczego.

2. Utwórz kod

Wyślij adres docelowy metodą POST na /v1/codes, z kluczem jako tokenem bearer i Idempotency-Key, aby ponowione żądanie nigdy nie utworzyło duplikatu.

curl -X POST https://api.dotwick.com/v1/codes \  -H "Authorization: Bearer sk_live_…" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: van-014-2026-09-10" \  -d '{    "name": "Van fleet – unit 14",    "content": {      "type": "url",      "url": "https://example.com/fleet/van-014"    },    "design": {      "pattern": "rounded",      "eyes": {        "frame": "circle",        "ball": "circle"      },      "colors": {        "fg": "#18181B",        "bg": "#FFFFFF"      }    },    "folderId": "fld_8k2m4q7x"  }'

{  "id": "qr_8841ce2mxk",  "name": "Van fleet – unit 14",  "type": "url",  "dynamic": true,  "status": "active",  "slug": "Xq7mK2p",  "shortUrl": "https://dotwick.co/Xq7mK2p",  "content": {    "type": "url",    "url": "https://example.com/fleet/van-014"  },  "folderId": "fld_8k2m4q7x",  "createdAt": "2026-09-10T09:41:08.000Z"}

3. Przetestuj go

shortUrl z odpowiedzi działa od razu. Zeskanuj go lub otwórz w przeglądarce: przekieruje na Twój adres docelowy, a skan pojawi się w statystykach w ciągu kilku sekund.

Dalej: zmień adres docelowy przez PATCH /v1/codes/{id} albo zarejestruj webhook, by słyszeć o każdym skanie.