Dosyalar

GetQR API’si beta aşamasındadır ve seçili çalışma alanlarında kullanılabilir. Ayrıntılar genel sürümden önce değişebilir.

PDF, görsel ve video QR kodları bir dosyaya yönlendirir; özel bir logo da bir dosyadır. Yükleme iki adımdan oluşur: bir URL almak için dosyayı kaydedin, ardından dosyanın baytlarını bu URL’ye gönderin.

Yöntem	Yol	Açıklama
`POST`	`/api/v1/files`	Dosya yüklemesi kaydetme

Dosya yükleyin

Dosyayı kaydedin

Dosyanın target, contentType ve size değerleriyle Dosya yüklemesi kaydetme uç noktasını çağırın. target, kabul edilen içerik türlerini ve boyut sınırını belirler. Bir fileId ve bir uploadUrl alırsınız.

Dosyayı gönderin

Dosyayı uploadUrl adresine bir PUT isteğiyle gönderin. İsteğin Content-Type ve Content-Length değerleri, kaydettiğiniz contentType ve size ile birebir eşleşmelidir: aksi hâlde istek reddedilir. URL önceden imzalanmıştır, bu yüzden API anahtarınızı eklemeyin. URL’nin süresi 10 dakika sonra dolar.

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

Dosya kimliğini kullanın

QR kodu oluştururken fileId değerini gönderin:

Bir pdf, image veya video QR kodu için fileId olarak. Eşleşen hedefle yükleyin.
Bir vcard, social, multilink veya event QR kodunun profil görseli için fileId olarak. logo hedefiyle yükleyin.
Özel bir logo için, logoOptions.type değeri uploaded olacak şekilde logoOptions.fileId olarak. logo hedefiyle yükleyin. Bkz. Özelleştirme.

Sınırlar

`target`	Kabul edilen içerik türleri	En büyük boyut
`pdf`	`application/pdf`	20 MB (20.971.520 bayt)
`image`	`image/*`	5 MB (5.242.880 bayt)
`video`	`video/*`	50 MB (52.428.800 bayt)
`logo`	`image/*`	5 MB (5.242.880 bayt)

Yalın MIME türü. image/png gibi küçük harfli tek bir tür ve alt tür gönderin. ;charset= gibi parametreler ve listeler reddedilir.
SVG yok. image/svg+xml gibi XML tabanlı türler kabul edilmez. image/png veya image/jpeg gibi raster bir görsel yükleyin.

Başlıklar

string

gerekli

Bearer ve ardından API anahtarınız. Bkz. Kimlik doğrulama.

string

gerekli

application/json.

Dosya yüklemesi kaydetme

POST /api/v1/files Bir dosyayı kaydeder ve dosyanın yükleneceği önceden imzalanmış bir URL döndürür. Bu çağrı dosyanın kendisini yüklemez.

string

gerekli

Dosyanın amacı: pdf, image, video veya logo. Kabul edilen içerik türlerini ve boyut sınırını belirler. Bkz. Sınırlar.

string

gerekli

Dosyanın parametresiz MIME türü; örneğin application/pdf. Yükleme isteği tam olarak bu Content-Type değerini göndermelidir.

integer

gerekli

Dosyanın bayt cinsinden tam boyutu; pozitif bir tam sayı. Hedefin sınırına göre kontrol edilir. Yükleme isteği tam olarak bu Content-Length değerini göndermelidir.

string

Orijinal dosya adı; en fazla 255 karakter. Panelde göstermek için saklanır. / veya \ içeren bir yol reddedilir.

string

fileId veya logoOptions.fileId olarak gönderilecek kimlik.

string

Dosyanın PUT ile gönderileceği önceden imzalanmış URL.

integer

uploadUrl süresinin dolmasına kalan saniye: 600.

string

Yükleme için HTTP yöntemi: 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"
}

Sık karşılaşılan sorunlar

422 "Content type … is not allowed for target"

İçerik türü hedefle eşleşmiyor. Örneğin pdf yalnızca application/pdf kabul eder. Bkz. Sınırlar.

422 "must be a single lowercase type/subtype"

İçerik türünü küçük harflerle ve parametresiz gönderin: Image/PNG veya image/png; charset=utf-8 değil, image/png.

422 "File is too large for target"

Bildirilen size, hedefin sınırını aşıyor. Dosyayı kaydetmeden önce sıkıştırın.

uploadUrl adresine yükleme başarısız oluyor

URL’nin süresi dosyayı kaydettikten 10 dakika sonra dolar ve istek, kaydedilen Content-Type ve Content-Length değerlerini birebir göndermelidir. Yeni bir URL almak için dosyayı yeniden kaydedin.

QR kodu oluştururken 422 "is registered but its content was never uploaded"

Dosyayı kaydettiniz ancak uploadUrl adresine yapılan PUT tamamlanmadı. Dosyayı yükleyin, ardından QR kodunu oluşturun.

QR kodu oluştururken 422 "was uploaded to …"

Dosya farklı bir hedefle kaydedilmiş; örneğin bir pdf QR kodu için kullanılan bir image dosyası. Eşleşen hedefle yeni bir yükleme kaydedin.

QR kodu oluştururken 404 "File … was not found"

fileId mevcut değil. Bu değeri Dosya yüklemesi kaydetme yanıtından alın.

API

Dosya yükleyin

Sınırlar

Başlıklar

Dosya yüklemesi kaydetme

Sık karşılaşılan sorunlar

Sırada ne var

QR kodları

QR türleri

Özelleştirme

Hatalar

​Dosya yükleyin

​Sınırlar

​Başlıklar

​Dosya yüklemesi kaydetme

​Sık karşılaşılan sorunlar

​Sırada ne var

QR kodları

QR türleri

Özelleştirme

Hatalar

Dosya yükleyin

Sınırlar

Başlıklar

Dosya yüklemesi kaydetme

Sık karşılaşılan sorunlar

Sırada ne var