Barkod API
Barkod numarasını doğrulayın, kontrol hanesini hesaplayın, ürünü bulun; barkod görseli üretin ya da fotoğraftan okuyun.
/v1/barkod/dogrula numaranın türünü (EAN-13, EAN-8, UPC-A, UPC-E, GTIN-14, ISBN-10/13, ISSN, ISMN), kontrol hanesinin doğruluğunu ve beklenen değerini, GTIN-14 karşılığını ve GS1 önekini (ör. 868–869 GS1 Türkiye) verir. GS1 öneki numarayı tahsis eden kuruluşu gösterir, ürünün üretildiği ülkeyi değil; 2 ile başlayan mağaza içi numaralar ayrıca işaretlenir.
/v1/barkod/sorgula ürün adını, markayı, miktarı, kategorileri, görseli, içindekileri, alerjenleri ve 100 g başına besin değerlerini Open Food Facts, Open Beauty Facts ve Open Products Facts açık veritabanlarından getirir. Her barkod bulunmaz: bulunamayan ürün bulundu: false döner. Sonuçlar önbelleğe alınır.
/v1/barkod/olustur EAN-13, EAN-8, UPC-A/E, ITF-14, Code 128/39/93, Codabar, Data Matrix, PDF417 ve Aztec görseli üretir (SVG, PNG, WebP; eksik kontrol hanesi eklenir). /v1/barkod/oku fotoğraftaki barkodları okur.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004"
Örnek yanıt
GET https://api.veriapi.pro/v1/barkod/dogrula?kod=8690504020004 — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"girdi": "8690504020004",
"kod": "8690504020004",
"gecerli": true,
"tur": "EAN-13",
"olasi_turler": [
"EAN-13",
"GTIN-13"
],
"kontrol_hanesi": 4,
"beklenen_kontrol_hanesi": 4,
"gtin14": "08690504020004",
"gs1": {
"onek": "869",
"kurulus": "GS1 Türkiye",
"kisitli": false,
"not": "GS1 öneki numarayı tahsis eden GS1 üye kuruluşunu gösterir; ürünün üretildiği ülke (menşei) olmak zorunda değildir."
},
"hata": null
},
"kaynak": [
{
"kod": "gs1_onek",
"ad": "GS1 önek listesi",
"lisans": "Olgu (GS1 üye kuruluş önek tahsisleri)",
"atif": "GS1 öneki numarayı tahsis eden kuruluşu gösterir, ürünün menşeini değil",
"url": "https://www.gs1.org/standards/id-keys/company-prefix"
},
{
"kod": "hesap",
"ad": "VeriApi.Pro hesaplaması",
"lisans": "VeriApi.Pro",
"atif": "VeriApi.Pro tarafından hesaplanmıştır",
"url": null
}
],
"guncelleme": null,
"bayat": false
}
Uçlar ve parametreler
GET /v1/barkod/dogrula
ücretsiz pakette
1 birim
Barkod doğrulama: tür, kontrol hanesi, GS1 öneki, ISBN
| Parametre | Tür | Açıklama |
|---|---|---|
| kod* | metin | Barkod numarası |
GET /v1/barkod/sorgula
ücretsiz pakette
5 birim
Barkoddan ürün adı, marka, görsel, besin değerleri
| Parametre | Tür | Açıklama |
|---|---|---|
| kod* | metin | EAN-13 / EAN-8 / UPC barkodu |
GET /v1/barkod/olustur
ücretsiz pakette
1 birim
Barkod görseli üret (EAN-13, EAN-8, UPC, ITF-14, Code 128/39/93, Data Matrix, PDF417, Aztec)
| Parametre | Tür | Açıklama |
|---|---|---|
| kod* | metin | İçerik (sayısal türlerde kontrol hanesi eklenir) |
| tur | metin | ean13, ean8, upca, upce, itf14, code128, code39, code93, codabar, datamatrix, pdf417, aztec varsayılan: ean13 |
| bicim | metin | svg, png, webp varsayılan: svg |
| olcek | tam sayı | Çizgi kalınlığı (px) varsayılan: 3 |
| yazi | evet/hayır | Altına okunur numara (EAN/UPC/Code) varsayılan: True |
| cikti | metin | dosya ya da json varsayılan: dosya |
GET /v1/barkod/kontrol-hanesi
ücretsiz pakette
1 birim
Kontrol hanesini hesapla (7 → EAN-8, 11 → UPC-A, 12 → EAN-13, 13 → GTIN-14)
| Parametre | Tür | Açıklama |
|---|---|---|
| kod* | metin |
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓Stok ve e-ticaret formlarında barkod doğrulama
- ✓Barkoddan ürün adı ve görselini otomatik doldurmak
- ✓Etiket basmak için EAN-13 / Code 128 görseli
- ✓Mobil uygulamada fotoğraftan barkod okumak
Kaynak ve lisans
- GS1 önek listesi · Olgu (GS1 üye kuruluş önek tahsisleri) · kaynak
Atıf: GS1 öneki numarayı tahsis eden kuruluşu gösterir, ürünün menşeini değil
- Open Food Facts · ODbL 1.0 (veritabanı), DbCL 1.0 (içerik), CC BY-SA 3.0 (görseller) · kaynak
Atıf: Ürün verisi: Open Food Facts katkıcıları (ODbL), https://world.openfoodfacts.org
- VeriApi.Pro hesaplaması · VeriApi.Pro
Atıf: VeriApi.Pro tarafından hesaplanmıştır
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Barkoddan ürün bulma ücretsiz mi?
Evet; /v1/barkod/sorgula her pakette açıktır, istek 5 birimdir. Ürün adına göre arama ve toplu doğrulama ücretli paketlerdedir.
Her barkodun ürünü bulunur mu?
Hayır. Veri gönüllülerin oluşturduğu açık veritabanlarından gelir; özellikle gıda dışı ürünlerde kapsam sınırlıdır. Bulunamayınca bulundu: false döner.
869 ile başlayan barkod Türk malı mı demek?
Hayır; 868–869 öneki numaranın GS1 Türkiye tarafından tahsis edildiğini gösterir. Ürün başka ülkede üretilmiş olabilir.
Bu sayfa şu aramalar için de: barkod sorgulama api · ean13 doğrulama · barkoddan ürün bulma api · gtin kontrol hanesi hesaplama