QR-codes

​

Het QR-code-object

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "qrType": "website",
  "title": "Landing page",
  "description": null,
  "data": "https://getqr.sh/x7Kd2p1",
  "archived": false,
  "isStatic": false,
  "shortLink": "https://getqr.sh/x7Kd2p1",
  "domain": "getqr.sh",
  "key": "x7Kd2p1",
  "keyIsCustom": false,
  "url": "https://example.com",
  "ios": null,
  "android": null,
  "scans": 128,
  "access": {
    "passwordProtected": false,
    "activeAt": null,
    "pauseAt": null,
    "scanLimit": null
  },
  "designKind": "custom",
  "design": {
    "styles": { "dotsOptions": { "type": "rounded", "color": "#1E40AF" }, … },
    "frameOptions": { "id": "card", "text": "Scan me!", … },
    "logoOptions": { "type": "suggested", "id": "logo-website-3", "scalePercent": 25 }
  },
  "file": null,
  "appName": null,
  "pdfBundle": null,
  "imageGallery": null,
  "createdAt": "2026-08-01T10:00:00.000Z",
  "updatedAt": "2026-08-01T10:00:00.000Z"
}

​

QR-codes weergeven

curl "https://getqr.com/api/v1/qrs?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "data": [
    {
      "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
      "qrType": "website",
      "title": "Landing page",
      "shortLink": "https://getqr.sh/x7Kd2p1",
      "url": "https://example.com",
      "scans": 128,
      "…": "…"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}

​

Een QR-code maken

curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: landing-page-2026-08" \
  -d '{
    "qrType": "website",
    "data": "https://example.com",
    "title": "Landing page",
    "access": { "scanLimit": 500 }
  }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "qrType": "website",
  "title": "Landing page",
  "data": "https://getqr.sh/x7Kd2p1",
  "shortLink": "https://getqr.sh/x7Kd2p1",
  "url": "https://example.com",
  "scans": 0,
  "access": { "passwordProtected": false, "activeAt": null, "pauseAt": null, "scanLimit": 500 },
  "…": "…"
}

​

Herhaalde pogingen en duplicaten

• Met een sleutel. Met een Idempotency-Key-header wordt het antwoord 24 uur lang opnieuw afgespeeld.
• Zonder sleutel. Een identieke body die binnen 30 seconden wordt verstuurd, wordt als duplicaat behandeld.
• Herhalingen. Een herhaling geeft het opgeslagen antwoord terug met x-idempotent-replay: true. Een nieuwe QR-code geeft false.
• Nog bezig. Een tweede verzoek terwijl het eerste nog loopt, krijgt 409 conflict.
• Mislukkingen. Een mislukte aanmaak geeft de sleutel meteen vrij, zodat je het met dezelfde sleutel opnieuw kunt proberen.
• Naar beste vermogen. Is de beveiliging tegen duplicaten niet beschikbaar, dan gaan aanmaakverzoeken onbeschermd door.

​

Een QR-code ophalen

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY"

​

Een QR-code bijwerken

• templateId. Niet toegestaan.
• link. Gedeeltelijk. De huidige bestemming blijft behouden als je link.url weglaat. link.domain en link.key krijgen 422: de korte link is wat de gedrukte code codeert, dus maak een nieuwe QR-code als je een andere wilt.
• data. Wordt alleen tegen het resulterende type gecontroleerd als data of qrType verandert. Wissel je qrType zonder bijpassende data, dan wordt dat geweigerd. Zie Van type wisselen.
• Ontwerp. styles, frameOptions en logoOptions worden samengevoegd met het opgeslagen ontwerp, dus een gedeeltelijk object wijzigt alleen wat het noemt. Kies je een ander logo, dan vervangt dat het oude, maar blijft de grootte behouden.
• access. Elke sleutel wordt toegepast als hij aanwezig is. null wist een regel. Toegangsregels horen onder access: stuur je ze onder link, dan krijg je 422.
• archived. Pauzeert of heractiveert de QR-code en de korte link samen, net als Pauzeren en Heractiveren.

curl -X PATCH "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Autumn campaign",
    "access": { "password": "s3cr3t", "passwordProtected": true }
  }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "title": "Autumn campaign",
  "access": { "passwordProtected": true, "activeAt": null, "pauseAt": null, "scanLimit": null },
  "…": "…"
}

​

De gepauzeerde status instellen

curl -X PUT "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "archived": true }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": true,
  "…": "…"
}

​

Een QR-code pauzeren

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/pause" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": true,
  "…": "…"
}

​

Een QR-code heractiveren

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/activate" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": false,
  "…": "…"
}

​

Een QR-code dupliceren

• Korte link. De kopie krijgt een eigen korte link, met een willekeurige slug op het standaarddomein van de workspace, niet op het domein van het origineel. De scans worden apart geteld.
• Titel. De titel krijgt het achtervoegsel (Copy). Het resultaat blijft binnen 40 tekens: een lange titel wordt eerst ingekort. Een QR-code zonder titel blijft zonder titel.
• Niet gekopieerd. Toegangsregels (wachtwoord, planning, scanlimiet) en de gepauzeerde status. De kopie is altijd actief.
• Bestanden. Pdf- en afbeeldingsbestanden, ook die van bundels en galerijen, worden gekopieerd, zodat de kopie ze zelf bezit. Videobestanden en ontwerpbestanden, zoals logo’s, worden gedeeld met het origineel.

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/duplicate" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_7Hk2PqWmX9cTnV4sLbR8YdZe",
  "title": "Landing page (Copy)",
  "shortLink": "https://getqr.sh/p2Wq9dL",
  "url": "https://example.com",
  "archived": false,
  "scans": 0,
  "…": "…"
}

​

Een QR-code verwijderen

curl -X DELETE "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{ "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "deleted": true }

​

Een QR-codeafbeelding downloaden

• Body. De body van het antwoord is het bestand. De voorgestelde bestandsnaam staat in de Content-Disposition-header, opgebouwd uit de titel, of qr-code voor een QR-code zonder titel.
• Caching. Antwoorden bevatten een ETag en Cache-Control: private, max-age=3600, must-revalidate. Stuur de ETag terug in If-None-Match om 304 Not Modified te krijgen als de QR-code niet is veranderd.
• Fouten. Een niet-ondersteund formaat of een niet-ondersteunde resolutie krijgt 400 bad_request. Het foutbericht noemt de reden: qr_download_invalid_format, qr_download_invalid_resolution, qr_download_art_format_unsupported of qr_download_art_resolution_unsupported.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/download?format=png&resolution=1024" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  --output qr-code.png

HTTP/1.1 200 OK
Content-Type: image/png
Content-Disposition: attachment; filename="landing-page-1024px.png"
ETag: "9f2c0e1b5a7d43c8b016e2f4a9d5c3718be40f92"
Cache-Control: private, max-age=3600, must-revalidate

<binary image data>

​

Toegangsregels

​

Ontwerpobjecten

​

Veelvoorkomende problemen

​

Volgende stappen