Hopp til hovedinnhold
GetQR API-et er i beta og er tilgjengelig for utvalgte arbeidsområder. Detaljer kan endres før den generelle lanseringen.
PDF-, bilde- og video-QR-koder peker mot en fil, og en egen logo er også en fil. Opplasting skjer i to trinn: registrer filen for å få en URL, og send deretter innholdet til den URL-en.

​
Last opp en fil

1

Registrer filen

Kall Registrer en filopplasting med filens target, contentType og size. target bestemmer hvilke innholdstyper som godtas, og størrelsesgrensen. Du får en fileId og en uploadUrl.
2

Send filen

Send filen med en PUT-forespørsel til uploadUrl. Content-Type og Content-Length må stemme nøyaktig med contentType og size du registrerte: alt annet avvises. URL-en er forhåndssignert, så ikke legg til API-nøkkelen din. Den utløper etter 10 minutter.
3

Bruk fil-ID-en

Send fileId når du oppretter en QR-kode:
  • Som fileId for en pdf-, image- eller video-QR-kode. Last opp med tilsvarende target.
  • Som fileId for profilbildet til en vcard-, social-, multilink- eller event-QR-kode. Last opp med target logo.
  • Som logoOptions.fileId, med logoOptions.type satt til uploaded, for en egen logo. Last opp med target logo. Se Tilpasning.

​
Grenser

  • Ren MIME-type. Send én type og undertype med små bokstaver, for eksempel image/png. Parametere som ;charset= og lister avvises.
  • Ingen SVG. XML-baserte typer som image/svg+xml godtas ikke. Last opp et rasterbilde, for eksempel image/png eller image/jpeg.

​
Headere

​
string
påkrevd
Bearer etterfulgt av API-nøkkelen din. Se Autentisering.
​
string
påkrevd
application/json.

​
Registrer en filopplasting

POST /api/v1/files Registrerer en fil og returnerer en forhåndssignert URL som filen skal lastes opp til. Dette kallet laster ikke opp selve filen.
​
string
påkrevd
Hva filen skal brukes til: pdf, image, video eller logo. Bestemmer hvilke innholdstyper som godtas, og størrelsesgrensen. Se Grenser.
​
string
påkrevd
MIME-typen til filen, for eksempel application/pdf, uten parametere. Opplastingsforespørselen må sende nøyaktig denne Content-Type.
​
integer
påkrevd
Nøyaktig filstørrelse i byte, et positivt heltall. Kontrolleres mot grensen for target. Opplastingsforespørselen må sende nøyaktig denne Content-Length.
​
string
Opprinnelig filnavn, opptil 255 tegn. Beholdes for visning i dashbordet. En bane med / eller \ avvises.
​
string
ID som skal sendes som fileId eller logoOptions.fileId.
​
string
Forhåndssignert URL som filen skal sendes til med PUT.
​
integer
Sekunder til uploadUrl utløper: 600.
​
string
HTTP-metode for opplastingen: PUT.

​
Vanlige problemer

Innholdstypen passer ikke til target. For eksempel godtar pdf bare application/pdf. Se Grenser.
Send innholdstypen med små bokstaver og uten parametere: image/png, ikke Image/PNG eller image/png; charset=utf-8.
Den oppgitte size er over grensen for target. Komprimer filen før du registrerer den.
URL-en utløper 10 minutter etter at du registrerte filen, og forespørselen må sende nøyaktig den registrerte Content-Type og Content-Length. Registrer filen på nytt for å få en ny URL.
Du registrerte filen, men PUT til uploadUrl ble ikke fullført. Last opp filen, og opprett deretter QR-koden.
Filen ble registrert med et annet target, for eksempel en image-fil brukt til en pdf-QR-kode. Registrer en ny opplasting med tilsvarende target.
fileId finnes ikke. Hent den fra svaret på Registrer en filopplasting.

​
Neste steg

QR-koder

QR-kodedata per type

Tilpasning

Feil