Spring til hovedindhold
GetQR API’et er i beta og er tilgængeligt for udvalgte arbejdsområder. Detaljer kan ændre sig før den generelle udgivelse.
PDF-, billed- og video-QR-koder peger på en fil, og et eget logo er også en fil. Upload sker i to trin: Registrer filen for at få en URL, og send derefter filens bytes til den URL.

​
Upload en fil

1

Registrer filen

Kald Registrer en filupload med filens target, contentType og size. target bestemmer de accepterede indholdstyper og størrelsesgrænsen. Du får en fileId og en uploadUrl.
2

Send filen

Send filen med en PUT-forespørgsel til uploadUrl. Dens Content-Type og Content-Length skal svare præcis til den contentType og size, du registrerede: Alt andet afvises. URL’en er forhåndssigneret, så tilføj ikke din API-nøgle. Den udløber efter 10 minutter.
3

Brug fil-id'et

Angiv fileId, når du opretter en QR-kode:
  • Som fileId til en pdf-, image- eller video-QR-kode. Upload med det tilsvarende target.
  • Som fileId til profilbilledet på en vcard-, social-, multilink- eller event-QR-kode. Upload med target logo.
  • Som logoOptions.fileId, med logoOptions.type sat til uploaded, til et eget logo. Upload med target logo. Se Tilpasning.

​
Grænser

  • Ren MIME-type. Send én type og undertype med små bogstaver, f.eks. image/png. Parametre som ;charset= og lister afvises.
  • Ingen SVG. XML-baserede typer som image/svg+xml accepteres ikke. Upload et rasterbillede som image/png eller image/jpeg.

​
Headere

​
string
påkrævet
Bearer efterfulgt af din API-nøgle. Se Godkendelse.
​
string
påkrævet
application/json.

​
Registrer en filupload

POST /api/v1/files Registrerer en fil og returnerer en forhåndssigneret URL, som filen skal uploades til. Kaldet uploader ikke selve filen.
​
string
påkrævet
Hvad filen skal bruges til: pdf, image, video eller logo. Bestemmer de accepterede indholdstyper og størrelsesgrænsen. Se Grænser.
​
string
påkrævet
Filens MIME-type, f.eks. application/pdf, uden parametre. Upload-forespørgslen skal sende præcis denne Content-Type.
​
integer
påkrævet
Filens nøjagtige størrelse i bytes, et positivt heltal. Kontrolleres mod grænsen for target. Upload-forespørgslen skal sende præcis denne Content-Length.
​
string
Det oprindelige filnavn, op til 255 tegn. Gemmes til visning i dashboardet. En sti med / eller \ afvises.
​
string
Id, der angives som fileId eller logoOptions.fileId.
​
string
Forhåndssigneret URL, som filen sendes til med PUT.
​
integer
Sekunder, til uploadUrl udløber: 600.
​
string
HTTP-metode til uploaden: PUT.

​
Almindelige problemer

Indholdstypen passer ikke til target. F.eks. accepterer pdf kun application/pdf. Se Grænser.
Send indholdstypen med små bogstaver og uden parametre: image/png, ikke Image/PNG eller image/png; charset=utf-8.
Den angivne size overskrider grænsen for target. Komprimer filen, før du registrerer den.
URL’en udløber 10 minutter efter, at du har registreret filen, og forespørgslen skal sende præcis den registrerede Content-Type og Content-Length. Registrer filen igen for at få en ny URL.
Du har registreret filen, men PUT til uploadUrl blev ikke gennemført. Upload filen, og opret derefter QR-koden.
Filen blev registreret med et andet target, f.eks. en image-fil brugt til en pdf-QR-kode. Registrer en ny upload med det tilsvarende target.
fileId findes ikke. Hent det fra svaret på Registrer en filupload.

​
Næste skridt

QR-koder

QR-kodedata efter type

Tilpasning

Fejl