QRbanner REST API v1, script’ler, backend’ler ve CI hatlarından QR kodları oluşturmanıza, güncellemenize ve düzenlemenize olanak tanır. API anahtarları ücretsiz planda kullanılabilir — satış görüşmesi gerekmez.
API anahtarı oluşturun
- Giriş yapın ve Panel → Ayarlar → API Anahtarları’nı açın
- Açıklayıcı bir adla anahtar oluşturun (ör. “Production backend”)
- Anahtarı bir kez kopyalayın — yalnızca oluşturma anında gösterilir
- Her istekte Authorization: Bearer veya X-API-Key olarak gönderin
İlk QR kodunuzu oluşturun
name, category ve qr_data içeren JSON gövdesiyle POST /api/v1/qr gönderin. URL kodları { "url": "https://..." } gerektirir. Yanıt short_code ve tarama URL’sini içerir.
Tarama webhook’larını alın
Ayarlar → Tarama Webhook’ları altında bir HTTPS uç noktası ekleyin. Her tarama event, qr_code_id ve tarama meta verisiyle JSON POST eder. Webhook gizli anahtarınızla HMAC-SHA256 kullanarak X-QRbanner-Signature’ı doğrulayın. Aynı panelde teslimat geçmişini inceleyin.
OpenAPI spesifikasyonu
Postman, Insomnia veya API gateway’inize REST API v1’i içe aktarmak için /developers veya /api/openapi.json adresinden openapi.json indirin — QR, klasör ve webhook şemalarını içerir.