REST API ile QR kod oluşturma: curl örnekleriyle rehber

Adım 1: Anahtar oluştur

Panelde Hesap altındaki „CLI, komut dosyaları ve ajanlar için erişim“ bölümünde bir anahtar oluşturursun. İlk denemeler için „salt okunur“ yeter. Kısa bir süre seç, örneğin 30 gün. Anahtar sqr_live_ ile başlar ve yalnızca bir kez gösterilir. Kabuk geçmişinde görünmesin diye onu bir ortam değişkenine koy, örneğin parola yöneticin üzerinden.

Adım 2: İlk istek

API https://sameqr.com/api/v1 adresinde bulunur. Anahtar Authorization başlığına gider, asla adrese değil:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

İlk istek hesabını, tarifeni ve sınırlarını gösterir, ikincisi QR kodlarını kimlik, ad, hedef, etiketler, tarama sayısı ve _rev durumuyla gösterir.

Adım 3: QR kod oluştur

Oluşturmak için „okuma + yazma“ yetkili ikinci bir anahtar gerekir. Okuma anahtarıyla API, değiştiren isteklere 403 ve NUR_LESEN koduyla yanıt verir. Yeni bir QR kod için en az bir ad ve bir hedef gerekir:

curl -X POST https://sameqr.com/api/v1/qr \
  -H "Authorization: Bearer $SAMEQR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Speisekarte","targetUrl":"https://example.com/karte"}'

Devam etmeden önce yeni QR kodu telefonunla tara. Oluşturmak için e-posta adresinin doğrulanmış olması gerekir ve QR kod tarifenin kotasından sayılır.

Adım 4: Hedefi değiştir

Hedef değişiklikleri özellikle korunur. „Tam“ yetkili bir anahtara ihtiyacın var ve QR kodun güncel durumunu X-Confirm başlığı olarak gönderirsin. Durumu okuma isteği verir:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>

curl -X PATCH https://sameqr.com/api/v1/qr/<id> \
  -H "Authorization: Bearer $SAMEQR_API_KEY" -H "Content-Type: application/json" \
  -H "X-Confirm: <stand>" \
  -d '{"targetUrl":"https://example.com/karte-neu"}'

Yalnızca gönderilen alanlar değişir. Durum uyuşmuyorsa, çünkü biri QR kodu bu arada değiştirdiyse, hiçbir şey üzerine yazılmaz. API üzerinden saatte en fazla 10 ve günde 30 hedef değişikliği yapılabilir, panelde bu sınır yoktur. Ücretsiz tarifede QR kod başına hedef değişikliği sayısı sınırlıdır.

Adım 5: Hataları ve sınırları anla

Hatalar her zaman aynı biçimde gelir: status, code ve message içeren bir error nesnesi. Bunları programında değerlendir, öylece devam etme.

• 401: Anahtar yok, yanlış, süresi dolmuş veya iptal edilmiş.
• 403: Anahtarda gerekli yetki düzeyi yok veya tarifen bu işleme izin vermiyor.
• BESTAETIGUNG_FEHLT ile 400: Hedef değişikliği, çevrimdışı yapma veya silme için güncel durumlu X-Confirm eksik.
• 409: Biri QR kodu bu arada değiştirdi.
• 429: Çok fazla istek. Anahtar başına dakikada 120 gider, saatte ücretsiz tarifede 60, Start'ta 300, Pro'da 1.000 ve Agentur'da 5.000.

Tüm istekleri /api/v1/openapi.json tanımlar, rehber sameqr.com/entwickler adresinde.

Sonuç: Neden Same-QR

Same-QR REST API'si düzenli, iyi belgelenmiş ve her tarifede var. Panelin yapabildiği her şeyi yapabilir, basılı QR kodları onay ve sınırlarla yanlışlıkla yapılacak hedef değişikliklerinden korur, üç düzeyde anahtara izin verir ve anlaşılır hatalarla yanıt verir.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, dokümantasyon sameqr.com/entwickler adresinde.

Sık sorulan sorular