API-referentie
Routes
Routes die hier niet staan, zijn alleen voor de app en antwoorden een sleutel met 403 session_required. Routes die als idempotent zijn gemarkeerd, accepteren een Idempotency-Key.
Codes
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/codes | codes:read | Codes ophalen, filteren op map, type of status |
| POST | /v1/codes | codes:write | Een code aanmakenidempotent |
| GET | /v1/codes/{id} | codes:read | Een code ophalen met ontwerp en regels |
| PATCH | /v1/codes/{id} | codes:write | Bestemming, naam, ontwerp en regels wijzigen |
| DELETE | /v1/codes/{id} | codes:write | Een code verwijderen (de korte link antwoordt met 410) |
| POST | /v1/codes/move | codes:write | Codes naar een map verplaatsenidempotent |
| POST | /v1/codes/move-domain | codes:write | Codes naar een ander domein verplaatsenidempotent |
| POST | /v1/codes/tags | codes:write | Tags toevoegen of verwijderen bij veel codesidempotent |
| POST | /v1/codes/{id}/duplicate | codes:write | Een code duplicerenidempotent |
| PATCH | /v1/codes/bulk | codes:write | Veel codes pauzeren, hervatten, archiveren, taggen, verplaatsen of verwijderen |
| GET | /v1/utm-presets | codes:read | Opgeslagen UTM-presets ophalen |
| GET | /v1/codes/{id}/versions | codes:read | Bestemmingsgeschiedenis van een code |
| GET | /v1/codes/{id}/activity | codes:read | Activiteitenfeed van een code |
| GET | /v1/codes/{id}/export | codes:read | Downloaden als SVG, PNG, JPG, PDF of EPS |
| GET | /v1/codes/{id}/hosted-stats | codes:read | Tellers van een gehoste code |
| GET | /v1/codes/{id}/submissions | submissions:read | Antwoorden op een formuliercode |
| GET | /v1/codes/{id}/submissions/export | submissions:read | Formulierantwoorden als CSV |
| GET | /v1/gs1/products | codes:read | GS1-producten ophalen (de gs1-codes) |
| GET | /v1/codes/{id}/gs1/qualifiers | codes:read | Batch-, CPV- en serieniveaus van een GS1-code |
| GET | /v1/codes/{id}/gs1/print-runs | codes:read | Drukruns van een GS1-code |
| GET | /v1/codes/{id}/gs1/print-runs/{runId} | codes:read | Een drukrun opvragen en de bestandslinks ophalen |
Bulkruns
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| POST | /v1/codes/bulk | codes:write | Tot 500 codes aanmaken als één runidempotent |
| GET | /v1/bulk-imports | codes:read | Bulkruns ophalen |
| GET | /v1/bulk-imports/{id} | codes:read | Een bulkrun opvragen |
| GET | /v1/bulk-imports/{id}/rows | codes:read | Rijen van een bulkrun |
| GET | /v1/bulk-imports/{id}/results.csv | codes:read | Resultaten van een run als CSV |
| POST | /v1/bulk-imports/{id}/cancel | codes:write | Een run in de wachtrij of lopende run annulerenidempotent |
| POST | /v1/bulk-imports/{id}/retry | codes:write | De mislukte rijen van een run opnieuw proberenidempotent |
Analyse
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/analytics/summary | analytics:read | Totaal aantal scans voor een periode |
| GET | /v1/analytics/timeseries | analytics:read | Scans in de tijd |
| GET | /v1/analytics/breakdown | analytics:read | Top-landen, -apparaten en meer |
| GET | /v1/analytics/scans | analytics:read | Records per scan |
| GET | /v1/analytics/sparklines | analytics:read | Dagelijkse aantallen voor codes |
| GET | /v1/analytics/compare | analytics:read | Tot 4 codes vergelijken |
| GET | /v1/analytics/export | analytics:read | Scans als CSV (korte periodes) |
| POST | /v1/analytics/exports | analytics:read | Scans als CSV, op de achtergrond voorbereididempotent |
| GET | /v1/codes/{id}/analytics/summary | analytics:read | Totalen van één code |
| GET | /v1/codes/{id}/analytics/timeseries | analytics:read | Eén code in de tijd |
| GET | /v1/codes/{id}/analytics/breakdown | analytics:read | Toplijsten van één code |
| GET | /v1/codes/{id}/scans | analytics:read | Records per scan van één code |
| GET | /v1/codes/{id}/gs1/batches | analytics:read | Scans per batch van een GS1-code |
| GET | /v1/codes/{id}/downloads | analytics:read | Downloads per bestand van een Documenten-code |
| GET | /v1/analytics/locations | analytics:read | GPS-kaart van scans met toestemming |
| GET | /v1/codes/{id}/analytics/locations | analytics:read | GPS-kaart van één code |
| GET | /v1/alerts | analytics:read | Regels voor scanmeldingen ophalen |
Exports
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| POST | /v1/exports | codes:read | Veel codes exporteren als één ZIPidempotent |
| GET | /v1/exports | codes:read | Exports ophalen |
| GET | /v1/exports/{id} | codes:read | Een export opvragen en de ZIP-link ophalen |
Mappen
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/folders | folders:read | Mappen ophalen |
| POST | /v1/folders | folders:write | Een map aanmakenidempotent |
| GET | /v1/folders/{id} | folders:read | Een map ophalen |
| PATCH | /v1/folders/{id} | folders:write | Een map hernoemen of verplaatsen |
| DELETE | /v1/folders/{id} | folders:write | Een map verwijderen (codes gaan een niveau omhoog) |
Sjablonen
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/templates | templates:read | Ontwerpsjablonen ophalen |
| POST | /v1/templates | templates:write | Een sjabloon aanmakenidempotent |
| GET | /v1/templates/{id} | templates:read | Een sjabloon ophalen |
| PATCH | /v1/templates/{id} | templates:write | Een sjabloon wijzigen |
| DELETE | /v1/templates/{id} | templates:write | Een sjabloon verwijderen |
Uploads
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| POST | /v1/assets | codes:write | Een logo of bestand uploaden |
| GET | /v1/assets/{id} | codes:read | Een upload ophalen met een ondertekende URL |
Domeinen
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/domains | domains:read | Eigen domeinen ophalen |
| GET | /v1/domains/{id} | domains:read | Een domein en zijn status ophalen |
| GET | /v1/subdomain | domains:read | Het subdomein van de werkruimte en de bijbehorende links |
| GET | /v1/subdomain/availability | domains:read | Controleren of een subdomeinnaam vrij is |
Werkruimte
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/workspaces/current | elke sleutel | De werkruimte en het abonnement van de sleutel |
| GET | /v1/usage | elke sleutel | Abonnementslimieten en gebruik deze maand |
Webhooks
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/webhooks | webhooks:read | Webhook-endpoints ophalen |
| POST | /v1/webhooks | webhooks:write | Een endpoint en eventtypen registrerenidempotent |
| GET | /v1/webhooks/{id} | webhooks:read | Een endpoint ophalen |
| PATCH | /v1/webhooks/{id} | webhooks:write | Een endpoint wijzigen of weer inschakelen |
| DELETE | /v1/webhooks/{id} | webhooks:write | Een endpoint verwijderen |
| POST | /v1/webhooks/{id}/test | webhooks:write | Een webhook.test-event sturenidempotent |
| GET | /v1/webhooks/{id}/deliveries | webhooks:read | Leveringen van een endpoint |
| GET | /v1/webhooks/{id}/deliveries/{deliveryId} | webhooks:read | Een levering met zijn pogingen |
| POST | /v1/webhooks/{id}/deliveries/{deliveryId}/redeliver | webhooks:write | Een levering opnieuw sturenidempotent |
| POST | /v1/webhooks/{id}/recover | webhooks:write | Mislukte leveringen opnieuw sturenidempotent |
Rapporten
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| POST | /v1/reports | analytics:read | Een PDF- of CSV-analyserapport genererenidempotent |
| GET | /v1/reports | analytics:read | Gegenereerde rapporten ophalen |
| GET | /v1/reports/{id} | analytics:read | Een rapport opvragen en de link ophalen |
Zapier- en Make-hooks
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/hooks | webhooks:read | Integratiehooks ophalen |
| POST | /v1/hooks | webhooks:write | Een hook abonneren op één eventidempotent |
| DELETE | /v1/hooks/{id} | webhooks:write | Een hook afmelden |
| GET | /v1/hooks/samples/{event} | webhooks:read | Recente events van een type, als voorbeeld voor een trigger |
Visitekaartjes
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/cards | cards:read | Visitekaartjes van het team ophalen |
| POST | /v1/cards | cards:write | Een visitekaartje aanmakenidempotent |
| GET | /v1/cards/{id} | cards:read | Een visitekaartje ophalen |
| PATCH | /v1/cards/{id} | cards:write | Een visitekaartje wijzigen |
| POST | /v1/cards/{id}/deactivate | cards:write | Een visitekaartje deactiverenidempotent |
| GET | /v1/cards/{id}/analytics | cards:read | Weergaven, opslagen en tikken van een kaartje |
Conversies
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| POST | /v1/conversions | conversions:write | Een conversie registrerenidempotent |
| GET | /v1/analytics/funnel | analytics:read | Funnel van scan tot omzet |
NFC-tags
| Methode | Pad | Scope | Doel |
|---|---|---|---|
| GET | /v1/nfc/tags | codes:read | NFC-tags ophalen |
| POST | /v1/nfc/tags | codes:write | Een NFC-tag registreren op een codeidempotent |