Przejdź do treści

Wyświetl kody

GET/v1/codes

Parametry zapytania

limitnumberopcjonalneRozmiar strony, od 1 do 100. Domyślnie 25.
cursorstringopcjonalnenextCursor poprzedniej strony.
folderIdstringopcjonalneTylko kody w tym folderze.
typestringopcjonalneTylko jeden typ kodu, np. url.
statusstringopcjonalneactive, paused, expired, scan_limit_reached lub disabled.
dynamicbooleanopcjonalnetrue lub false.
searchstringopcjonalneDopasowuje nazwę i slug.
sortstringopcjonalnecreated_at, updated_at, name lub scans; przedrostek - dla malejąco. Domyślnie -created_at.

Przykładowe żądanie

żądanieGET /v1/codes
curl "https://api.dotwick.com/v1/codes?folderId=fld_8k2m4q7x&status=active&limit=50" \  -H "Authorization: Bearer sk_live_…"
odpowiedź200 OK
{  "data": [    {      "id": "qr_8841ce2mxk",      "workspaceId": "ws_8f21ac4e9d0b7c11",      "name": "Van fleet – unit 14",      "type": "url",      "dynamic": true,      "status": "active",      "slug": "Xq7mK2p",      "domainId": null,      "shortUrl": "https://dotwick.co/Xq7mK2p",      "content": {        "type": "url",        "url": "https://example.com/fleet/van-014"      },      "design": {        "pattern": "rounded",        "eyes": {          "frame": "circle",          "ball": "circle"        },        "colors": {          "fg": "#18181B",          "bg": "#FFFFFF"        }      },      "rules": {        "routes": [],        "expiresAt": null,        "scanLimit": null,        "inactiveUrl": null,        "passwordProtected": false      },      "folderId": "fld_8k2m4q7x",      "templateId": null,      "createdBy": "u8Hk2LmN0pQ4rS6tV8wX0yZ2aB4cD6eF",      "createdAt": "2026-09-10T09:41:08.000Z",      "updatedAt": "2026-09-10T09:41:08.000Z",      "scans": 1284    }  ],  "nextCursor": "eyJ0IjoxNzU3NDk2ODY4fQ"}

Kolejne strony

Gdy nextCursor nie jest null, przekaż go jako cursor, aby dostać następną stronę. Klucz ograniczony do folderów widzi tylko kody w nich. Liczby skanów mogą się spóźniać o kilka sekund względem endpointów statystyk.