Fișiere

API-ul GetQR este în versiune beta și este disponibil pentru anumite spații de lucru. Detaliile se pot schimba înainte de lansarea generală.

Codurile QR PDF, Image și Video indică un fișier, iar un logo personalizat este tot un fișier. Încărcarea are doi pași: înregistrați fișierul pentru a obține un URL, apoi trimiteți octeții la acel URL.

Metodă	Cale	Descriere
`POST`	`/api/v1/files`	Înregistrarea unei încărcări de fișier

Încărcarea unui fișier

Înregistrați fișierul

Apelați Înregistrarea unei încărcări de fișier cu target, contentType și size ale fișierului. target stabilește tipurile de conținut acceptate și limita de dimensiune. Primiți un fileId și un uploadUrl.

Trimiteți fișierul

Trimiteți fișierul cu o cerere PUT la uploadUrl. Content-Type și Content-Length trebuie să corespundă exact cu contentType și size înregistrate: orice altceva este respins. URL-ul este presemnat, așa că nu adăugați cheia API. Expiră după 10 minute.

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @menu.pdf

Folosiți ID-ul fișierului

Transmiteți fileId când creați un cod QR:

Ca fileId pentru un cod QR pdf, image sau video. Încărcați cu targetul corespunzător.
Ca fileId pentru imaginea de profil a unui cod QR vcard, social, multilink sau event. Încărcați cu targetul logo.
Ca logoOptions.fileId, cu logoOptions.type setat la uploaded, pentru un logo personalizat. Încărcați cu targetul logo. Consultați Personalizare.

Limite

`target`	Tipuri de conținut acceptate	Dimensiune maximă
`pdf`	`application/pdf`	20 MB (20.971.520 de octeți)
`image`	`image/*`	5 MB (5.242.880 de octeți)
`video`	`video/*`	50 MB (52.428.800 de octeți)
`logo`	`image/*`	5 MB (5.242.880 de octeți)

Tip MIME simplu. Trimiteți un singur tip și subtip, cu litere mici, cum ar fi image/png. Parametrii precum ;charset= și listele sunt respinse.
Fără SVG. Tipurile bazate pe XML, cum ar fi image/svg+xml, nu sunt acceptate. Încărcați o imagine raster, cum ar fi image/png sau image/jpeg.

Anteturi

string

obligatoriu

Bearer urmat de cheia dvs. API. Consultați Autentificare.

string

obligatoriu

application/json.

Înregistrarea unei încărcări de fișier

POST /api/v1/files Înregistrează un fișier și returnează un URL presemnat la care să îl încărcați. Acest apel nu încarcă fișierul propriu-zis.

string

obligatoriu

Pentru ce este fișierul: pdf, image, video sau logo. Stabilește tipurile de conținut acceptate și limita de dimensiune. Consultați Limite.

string

obligatoriu

Tipul MIME al fișierului, de exemplu application/pdf, fără parametri. Cererea de încărcare trebuie să trimită exact acest Content-Type.

integer

obligatoriu

Dimensiunea exactă a fișierului în octeți, un număr întreg pozitiv. Este verificată în raport cu limita targetului. Cererea de încărcare trebuie să trimită exact acest Content-Length.

string

Numele original al fișierului, până la 255 de caractere. Păstrat pentru afișare în panou. O cale cu / sau \ este respinsă.

string

ID-ul de transmis ca fileId sau logoOptions.fileId.

string

URL-ul presemnat la care trimiteți fișierul cu PUT.

integer

Secundele până la expirarea uploadUrl: 600.

string

Metoda HTTP pentru încărcare: PUT.

curl -X POST "https://getqr.com/api/v1/files" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "pdf",
    "contentType": "application/pdf",
    "size": 248000,
    "name": "menu.pdf"
  }'

{
  "fileId": "file_7bQ2xR9mKp",
  "uploadUrl": "https://storage.getqr.com/qrs-content/pdf/file_7bQ2xR9mKp?X-Amz-...",
  "expiresIn": 600,
  "method": "PUT"
}

Probleme frecvente

422 "Content type … is not allowed for target"

Tipul de conținut nu corespunde targetului. De exemplu, pdf acceptă doar application/pdf. Consultați Limite.

422 "must be a single lowercase type/subtype"

Trimiteți tipul de conținut cu litere mici și fără parametri: image/png, nu Image/PNG sau image/png; charset=utf-8.

422 "File is too large for target"

size declarat depășește limita targetului. Comprimați fișierul înainte de a-l înregistra.

Încărcarea la uploadUrl eșuează

URL-ul expiră la 10 minute după înregistrarea fișierului, iar cererea trebuie să trimită exact Content-Type și Content-Length înregistrate. Înregistrați din nou fișierul pentru a obține un URL nou.

422 "is registered but its content was never uploaded" la crearea unui cod QR

Ați înregistrat fișierul, dar PUT la uploadUrl nu s-a finalizat. Încărcați fișierul, apoi creați codul QR.

422 "was uploaded to …" la crearea unui cod QR

Fișierul a fost înregistrat cu alt target, de exemplu un fișier image folosit pentru un cod QR pdf. Înregistrați o încărcare nouă cu targetul corespunzător.

404 "File … was not found" la crearea unui cod QR

fileId nu există. Preluați-l din răspunsul de la Înregistrarea unei încărcări de fișier.

API

Încărcarea unui fișier

Limite

Anteturi

Înregistrarea unei încărcări de fișier

Probleme frecvente

Ce urmează

Coduri QR

Tipuri de coduri QR

Personalizare

Erori

​Încărcarea unui fișier

​Limite

​Anteturi

​Înregistrarea unei încărcări de fișier

​Probleme frecvente

​Ce urmează

Coduri QR

Tipuri de coduri QR

Personalizare

Erori

Încărcarea unui fișier

Limite

Anteturi

Înregistrarea unei încărcări de fișier

Probleme frecvente

Ce urmează