Lister les codes
GET/v1/codes
Paramètres de requête
limitnumberfacultatifTaille de page, 1–100. 25 par défaut.cursorstringfacultatifnextCursor de la page précédente.folderIdstringfacultatifUniquement les codes de ce dossier.typestringfacultatifUniquement un type de code, par exemple url.statusstringfacultatifactive, paused, expired, scan_limit_reached ou disabled.dynamicbooleanfacultatiftrue ou false.searchstringfacultatifCorrespond au nom et au slug.sortstringfacultatifcreated_at, updated_at, name ou scans ; préfixe - pour l’ordre décroissant. -created_at par défaut.Exemple de requête
requêteGET /v1/codes
curl "https://api.dotwick.com/v1/codes?folderId=fld_8k2m4q7x&status=active&limit=50" \ -H "Authorization: Bearer sk_live_…"réponse200 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"}Pages suivantes
Quand nextCursor n’est pas null, passez-le comme cursor pour obtenir la page suivante. Une clé limitée à des dossiers ne voit que les codes qu’ils contiennent. Les compteurs de scans peuvent avoir quelques secondes de retard sur les endpoints de statistiques.