Masseopprettelse av QR-koder

curl "https://getqr.com/api/v1/bulk-qr-creations" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "processing",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 50,
  "createdCount": 18,
  "renderedCount": 12,
  "percent": 26,
  "stalled": false,
  "error": null,
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:20.000Z",
  "completedAt": null,
  "failedAt": null
}

null

curl "https://getqr.com/api/v1/bulk-qr-creations" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "processing",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 50,
  "createdCount": 18,
  "renderedCount": 12,
  "percent": 26,
  "stalled": false,
  "error": null,
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:20.000Z",
  "completedAt": null,
  "failedAt": null
}

null

GetQR API-et er i beta og er tilgjengelig for utvalgte arbeidsområder. Detaljer kan endres før den generelle lanseringen.

En masseopprettelse gjør en liste med navn og URL-er om til Website-QR-koder med ett felles design. Den kjører i bakgrunnen: start den, sjekk fremdriften jevnlig, og last deretter ned ZIP-arkivet.

Metode	Bane	Beskrivelse
`GET`	`/api/v1/bulk-qr-creations`	Hent den gjeldende masseopprettelsen
`POST`	`/api/v1/bulk-qr-creations`	Opprett fra JSON
`POST`	`/api/v1/bulk-qr-creations/csv`	Opprett fra en CSV-fil
`GET`	`/api/v1/bulk-qr-creations/{id}`	Hent en masseopprettelse
`DELETE`	`/api/v1/bulk-qr-creations/{id}`	Avbryt en masseopprettelse
`GET`	`/api/v1/bulk-qr-creations/{id}/download`	Last ned arkivet

Slik fungerer det

Start masseopprettelsen

Send radene dine med Opprett fra JSON eller Opprett fra en CSV-fil. API-et svarer 202 med masseopprettelsen og id.

Sjekk fremdriften

Kall Hent en masseopprettelse med noen sekunders mellomrom til status er completed eller failed.

Last ned arkivet

Når status er completed, kaller du Last ned arkivet for å få en ZIP med QR-kodebildene.

Grense. Opptil 100 rader per masseopprettelse.
Én om gangen. Bare én masseopprettelse kjører per arbeidsområde. Starter du en ny mens en kjører, returneres den som kjører.
Idempotens. Hver forespørsel krever en idempotencyKey. Gjentar du en forespørsel med samme nøkkel og samme body, returneres masseopprettelsen som allerede er startet. Samme nøkkel med en annen body returnerer 422.
Rader. Hver rad trenger name og url. Se Rader.
Abonnement. Masseopprettelse er ikke tilgjengelig på Single QR-abonnementet: forespørselen returnerer 403 exceeded_limit.

Rader

Navn. Blir tittelen på QR-koden. Mellomrom i starten og slutten fjernes, og navnet kortes ned til 40 tegn. Gjentatte navn (uavhengig av store og små bokstaver) får et nummer: Menu, Menu 2, Menu 3.
URL. Blir målet. Den må være en http- eller https-adresse med et ekte domene, for eksempel example.com/menu, og kan ikke inneholde mellomrom. En URL uten skjema får https://.
Tomme rader. Rader uten både navn og URL hoppes over. En rad med bare ett av dem avvises.

Hver QR-kode er en website-QR-kode med en kortlenke. Se QR-kodedata per type.

Headere

string

påkrevd

Bearer etterfulgt av API-nøkkelen din. Se Autentisering.

string

application/json for Opprett fra JSON, multipart/form-data for Opprett fra en CSV-fil.

Masseopprettelsesobjektet

string

ID-en til masseopprettelsen, for eksempel cm2k7x9qb0003ax8eb4f6gh2t.

string

queued, processing, packaging eller completed. En mislykket eller avbrutt masseopprettelse går via rollingBack til failed.

string

Navnet på kildefilen.

integer

Antall rader.

integer

QR-koder opprettet så langt.

integer

QR-kodebilder gjengitt så langt.

integer

Samlet fremdrift, 0 til 100. Oppretting tar opptil 40, gjengivelse opptil 90, pakking er 95, og completed er 100.

boolean

true når en masseopprettelse som kjører, ikke har hatt fremdrift på 2 minutter. Fortsett å sjekke: Hent en masseopprettelse starter en masseopprettelse som har stoppet opp, på nytt.

object | null

Når status er failed: code og message. En avbrutt masseopprettelse har koden cancelled_by_user. En mislykket masseopprettelse rulles tilbake, så ingen av QR-kodene beholdes.

string | null

Banen til Last ned arkivet, når status er completed.

string

Startdato, ISO 8601.

string

Dato for siste oppdatering, ISO 8601.

string | null

Dato for fullføring, ISO 8601.

string | null

Dato for feil, ISO 8601.

Hent den gjeldende masseopprettelsen

GET /api/v1/bulk-qr-creations Returnerer masseopprettelsen som fortsatt kjører i arbeidsområdet ditt. Når ingen kjører, returneres den siste avsluttede (completed eller failed) til den er avvist: det skjer når du laster ned arkivet eller avviser den i dashbordet. Ellers returneres null. Bruk den til å fortsette sporingen etter en omstart.

curl "https://getqr.com/api/v1/bulk-qr-creations" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "processing",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 50,
  "createdCount": 18,
  "renderedCount": 12,
  "percent": 26,
  "stalled": false,
  "error": null,
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:20.000Z",
  "completedAt": null,
  "failedAt": null
}

null

Opprett fra JSON

POST /api/v1/bulk-qr-creations Starter en masseopprettelse fra en liste med rader. Svarer 202 Accepted. Masseopprettelsen kjører i bakgrunnen.

object[]

påkrevd

QR-kodene som skal opprettes, opptil 100. Hver rad er { "name": "...", "url": "..." } og tar ingen andre felt. Se Rader.

object

påkrevd

Designet som brukes på hver QR-kode: styles, frameOptions og logoOptions, alle valgfrie. Send {} for standarddesignet. Andre felt avvises. Se Tilpasning.

string

påkrevd

Navnet som vises i dashbordet og brukes for arkivet, 1 til 255 tegn.

string

påkrevd

Din egen nøkkel for denne masseopprettelsen, 8 til 100 tegn.

curl -X POST "https://getqr.com/api/v1/bulk-qr-creations" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      { "name": "Menu", "url": "https://example.com/menu" },
      { "name": "Wine list", "url": "example.com/wine" }
    ],
    "design": { "styles": { "dotsOptions": { "type": "rounded" } } },
    "sourceFilename": "campaign-links.csv",
    "idempotencyKey": "campaign-2026-08-14"
  }'

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "queued",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 2,
  "createdCount": 0,
  "renderedCount": 0,
  "percent": 0,
  "stalled": false,
  "error": null,
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:00.000Z",
  "completedAt": null,
  "failedAt": null
}

Opprett fra en CSV-fil

POST /api/v1/bulk-qr-creations/csv Samme som Opprett fra JSON, men tar radene som en CSV-fil sendt som multipart/form-data. Svarer 202 Accepted. Filen må være en .csv på maksimalt 1 000 000 byte. Overskriftsraden må være nøyaktig name,url, etterfulgt av opptil 100 datarader. Se CSV-format.

file

påkrevd

CSV-filen.

string

påkrevd

Designobjektet, serialisert som JSON, for eksempel {"styles":{"dotsOptions":{"type":"rounded"}}}. Send {} for standarddesignet.

string

påkrevd

Din egen nøkkel for denne masseopprettelsen, 8 til 100 tegn.

string

Navnet som vises i dashbordet og brukes for arkivet, opptil 255 tegn. Standard er navnet på den opplastede filen.

curl -X POST "https://getqr.com/api/v1/bulk-qr-creations/csv" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -F "[email protected]" \
  -F 'design={"styles":{"dotsOptions":{"type":"rounded"}}}' \
  -F "idempotencyKey=campaign-2026-08-14"

name,url
Menu,https://example.com/menu
Wine list,example.com/wine

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "queued",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 2,
  "createdCount": 0,
  "renderedCount": 0,
  "percent": 0,
  "stalled": false,
  "error": null,
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:00.000Z",
  "completedAt": null,
  "failedAt": null
}

Hent en masseopprettelse

GET /api/v1/bulk-qr-creations/{id} Returnerer status og fremdrift for en masseopprettelse. Sjekk den jevnlig så lenge status er queued, processing eller packaging. downloadUrl vises når arkivet er klart.

string

påkrevd

ID-en til masseopprettelsen. Hent den fra svaret på opprettelsen eller på forespørselen om den gjeldende masseopprettelsen.

curl "https://getqr.com/api/v1/bulk-qr-creations/cm2k7x9qb0003ax8eb4f6gh2t" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "completed",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 50,
  "createdCount": 50,
  "renderedCount": 50,
  "percent": 100,
  "stalled": false,
  "error": null,
  "downloadUrl": "/api/v1/bulk-qr-creations/cm2k7x9qb0003ax8eb4f6gh2t/download",
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:02:10.000Z",
  "completedAt": "2026-08-14T08:02:10.000Z",
  "failedAt": null
}

Avbryt en masseopprettelse

DELETE /api/v1/bulk-qr-creations/{id} Stopper en masseopprettelse som kjører, og sletter QR-kodene den allerede har opprettet. Tilbakerullingen skjer under forespørselen, så svaret har normalt status failed og error.code cancelled_by_user. Avbryter du en masseopprettelse som allerede har mislyktes, returneres den uendret.

En fullført masseopprettelse kan ikke avbrytes: forespørselen returnerer 400. Slett i stedet QR-kodene én etter én med QR-koder.

string

påkrevd

ID-en til masseopprettelsen.

curl -X DELETE "https://getqr.com/api/v1/bulk-qr-creations/cm2k7x9qb0003ax8eb4f6gh2t" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "cm2k7x9qb0003ax8eb4f6gh2t",
  "status": "failed",
  "sourceFilename": "campaign-links.csv",
  "totalCount": 50,
  "createdCount": 18,
  "renderedCount": 12,
  "percent": 26,
  "stalled": false,
  "error": {
    "code": "cancelled_by_user",
    "message": "Bulk QR creation was cancelled."
  },
  "downloadUrl": null,
  "createdAt": "2026-08-14T08:00:00.000Z",
  "updatedAt": "2026-08-14T08:00:40.000Z",
  "completedAt": null,
  "failedAt": "2026-08-14T08:00:40.000Z"
}

Last ned arkivet

GET /api/v1/bulk-qr-creations/{id}/download Returnerer et ZIP-arkiv med én JPEG på 1024 px per QR-kode, med navn etter raden: 001-Menu.jpg, 002-Wine list.jpg og så videre. Arkivet får navn etter sourceFilename. Tilgjengelig når status er completed. Nedlastingen avviser masseopprettelsen, så Hent den gjeldende masseopprettelsen slutter å returnere den.

string

påkrevd

ID-en til masseopprettelsen.

curl "https://getqr.com/api/v1/bulk-qr-creations/cm2k7x9qb0003ax8eb4f6gh2t/download" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  --output qr-codes.zip

HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename="campaign-links-qr-codes.zip"

<binary archive data>

Vanlige problemer

422 med "contains an invalid HTTP(S) URL"

Meldingen navngir raden. Hver URL må være en http- eller https-adresse med et ekte domene, for eksempel example.com/menu. Rett raden og send forespørselen på nytt.

422 "CSV headers must be exactly: name,url."

Den første raden i CSV-filen må være name,url, i den rekkefølgen og med små bokstaver, uten andre kolonner.

422 "This idempotencyKey was already used with a different request body."

Nøkler kan ikke gjenbrukes for en annen bunt. Send en ny idempotencyKey.

409 "The bulk QR archive is not ready for download."

Masseopprettelsen er ikke fullført ennå. Fortsett å sjekke til status er completed.

400 "Cannot cancel a finished bulk QR creation."

Masseopprettelsen er allerede fullført, så den kan ikke rulles tilbake.

403 exceeded_limit

Arbeidsområdet ditt har Single QR-abonnementet, som ikke inkluderer masseopprettelse. Oppgrader abonnementet.

Jeg fikk tilbake en eldre masseopprettelse i stedet for en ny

En annen masseopprettelse kjører fortsatt i arbeidsområdet ditt, eller du har gjenbrukt en idempotencyKey. Vent til den er ferdig, eller bruk en ny nøkkel.

API

Masseopprettelse av QR-koder

Slik fungerer det

Rader

Headere

Masseopprettelsesobjektet

Hent den gjeldende masseopprettelsen

Opprett fra JSON

Opprett fra en CSV-fil

Hent en masseopprettelse

Avbryt en masseopprettelse

Last ned arkivet

Vanlige problemer

Neste steg

Tilpasning

QR-koder

Masseopprettelse i appen

CSV-format

​Slik fungerer det

​Rader

​Headere

​Masseopprettelsesobjektet

​Hent den gjeldende masseopprettelsen

​Opprett fra JSON

​Opprett fra en CSV-fil

​Hent en masseopprettelse

​Avbryt en masseopprettelse

​Last ned arkivet

​Vanlige problemer

​Neste steg

Tilpasning

QR-koder

Masseopprettelse i appen

CSV-format

Slik fungerer det

Rader

Headere

Masseopprettelsesobjektet

Hent den gjeldende masseopprettelsen

Opprett fra JSON

Opprett fra en CSV-fil

Hent en masseopprettelse

Avbryt en masseopprettelse

Last ned arkivet

Vanlige problemer

Neste steg