Barkod görseli API’si
Tek bir URL, tek bir barkod görseli — anahtar yok, SDK yok, kayıt yok. Bir HTML <img> etiketini, bir Markdown bağlantısını ya da bir hesap tablosu formülünü bu URL’e yöneltin; gerisi kendiliğinden çalışır.
Canlı — bu görseli tam şu anda aşağıdaki uç nokta oluşturuyor.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128Parametreler
| Parametre | Varsayılan | Sınırlar | Açıklama |
|---|---|---|---|
| data | zorunlu | 1–256 karakter | Kodlanacak değer. Kontrol basamakları (EAN-13, UPC-A, ITF-14, ISBN, …) kendiliğinden tamamlanır — sitedeki oluşturucuyla tam olarak aynı kural. Özel karakterleri URL kodlamasıyla yazın (düz bir + işareti boşluk olarak çözülür; bu, URL’leri ve =IMAGE() formüllerini okuyan her aracın beklediği standart sorgu dizesi kuralıdır). |
| type | code128 | desteklenen bir barkod türü kimliği (aşağıdaki tabloya bakın) | Hangi barkod türünün çizileceği. |
| scale | 3 | 1–8 | Modül genişliği çarpanı. Daha yüksek değerler daha büyük ve daha yüksek çözünürlüklü bir görsel verir — baskı için yükseltin, metnin içine giren küçük bir görsel için düşürün. |
| fmt | png | png ya da svg | Döndürülen görselin biçimi. SVG her boyuta kalite kaybı olmadan ölçeklenir; PNG ise SVG’yi göstermeyen hesap tabloları ve CMS’ler için daha güvenli varsayılandır. |
| addon | yok | tam olarak 5 basamak — yalnızca isbn ile | EAN-5 fiyat eki, yalnızca type=isbn ile uygulanır (ISBN oluşturucusundaki fiyat eki alanının karşılığı). Diğer bütün türlerde yok sayılır. |
| text | barkod türünün varsayılanı | 0 ya da 1 | Çubukların altındaki okunabilir karakterlerin çizilip çizilmeyeceği. text=0 yalnızca çubukları verir; text=1 metin satırını açar; parametreyi hiç yazmazsanız barkod türünün kendi varsayılanı geçerli olur (çoğu türde açık, Data Matrix ve QR Code’da kapalı). Başka herhangi bir değer 400 döndürür. |
Kopyalanmaya hazır kod parçacıkları
<img src="https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128" alt="Barcode for SKU-12345" width="300" height="100" />=IMAGE("https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128")Bu uç nokta ne yapar
GET /api/barcode, sitedeki oluşturucunun kullandığı data/type/scale parametrelerinin aynısını alır ve bir web sayfası yerine gerçek, çizilmiş bir barkod görseli döndürür — varsayılan olarak PNG, fmt=svg ile SVG. Herhangi bir HTML <img> etiketini, bir Markdown görsel bağlantısını ya da bir hesap tablosunun =IMAGE() formülünü bu URL’e yöneltin; barkod, URL’in gömüldüğü her yerde görünür — araya indirip yeniden yükleme adımı girmeden. GTIN ailesindeki türlerde kontrol basamakları tam da oluşturucudaki gibi kendiliğinden tamamlanır: type=ean13 altında 12 basamaklı bir data=, döndürülen görselde gerçek, 13 basamaklı ve okunabilir bir EAN-13 olur.
Makul kullanım — geniş sınırlar, anahtar gerekmez
Hiçbir hesap, API anahtarı ya da herhangi bir kimlik doğrulama yok: ihtiyacınız olan bütün parametreler URL’in içinde. Sınırlar ölçülüp faturalanmak yerine bilerek geniş tutuldu: data= için en fazla 256 karakter, scale= için 1–8 aralığı. Başarılı her yanıt Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable başlığını taşır; yani aynı URL hem tarayıcılarda hem CDN’lerde bir yıl boyunca önbellekte kalır — bu uç noktaya yönelen bin satırlık bir hesap tablosu, benzersiz her barkodu yalnızca bir kez oluşturur. Gerçek kötüye kullanım barındırma platformunun işidir, bu rotanın kendi uyguladığı bir şey değil. CORS de tamamen açık (Access-Control-Allow-Origin: * — başarılı ya da hatalı her yanıtta), dolayısıyla URL’i başka bir sitenin JavaScript kodundan fetch() ile çekmek — yalnızca düz bir HTML <img> etiketi olarak değil, bir <canvas> üzerine çizmek ya da data URL olarak gömmek için — her kaynaktan çalışır.
Desteklenen barkod türleri
| type= | Barkod | Kategori |
|---|---|---|
| code128 | Code 128 | General |
| code39 | Code 39 | General |
| ean13 | EAN-13 | Retail |
| ean8 | EAN-8 | Retail |
| upca | UPC-A | Retail |
| upce | UPC-E | Retail |
| itf14 | ITF-14 | Logistics |
| gs1-128 | GS1-128 | Logistics |
| datamatrix | Data Matrix | 2D |
| qrcode | QR Code | 2D |
| isbn | ISBN | Retail |
Sıkça sorulan sorular
Barkod API’si ücretsiz mi?
GET /api/barcode ücretsiz ve sınırsız — API anahtarı yok, hesap yok, istek başına sınır yok. Herkese açık bir görsel uç noktası: tıpkı başka herhangi bir görsel URL’i gibi bir hesap tablosundan, bir CMS’ten ya da bir README dosyasından doğrudan çağrılmak için yapıldı.Google E-Tablolar’da kullanabilir miyim?
=IMAGE("https://www.barcodesheets.com/api/barcode?data=DEGERINIZ&type=code128") yazın (ya da data= için başka bir hücrenin değerini gösterin), barkod tam orada oluşur ve değer değişince kendiliğinden güncellenir. Excel 365 (buluta bağlı) aynı =IMAGE() formülünü kabul eder.İstek sınırı var mı?
API hangi barkod türlerini destekler?
type= kimliğiyle çağrılır (örn. isbn kimliği için /isbn sayfası).