Elenca i codici
GET/v1/codes
Parametri della query
limitnumberfacoltativoDimensione della pagina, da 1 a 100. Predefinita 25.cursorstringfacoltativonextCursor della pagina precedente.folderIdstringfacoltativoSolo i codici in questa cartella.typestringfacoltativoUn solo tipo di codice, per esempio url.statusstringfacoltativoactive, paused, expired, scan_limit_reached o disabled.dynamicbooleanfacoltativotrue o false.searchstringfacoltativoCerca nel nome e nello slug.sortstringfacoltativocreated_at, updated_at, name o scans; prefisso - per ordine decrescente. Predefinito -created_at.Richiesta di esempio
richiestaGET /v1/codes
curl "https://api.dotwick.com/v1/codes?folderId=fld_8k2m4q7x&status=active&limit=50" \ -H "Authorization: Bearer sk_live_…"risposta200 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"}Altre pagine
Quando nextCursor non è null, passalo come cursor per ottenere la pagina successiva. Una chiave limitata a cartelle vede solo i codici al loro interno. I conteggi delle scansioni possono ritardare di qualche secondo rispetto agli endpoint delle statistiche.