Barkod API

Barkod numarasını doğrulayın, kontrol hanesini hesaplayın, ürünü bulun; barkod görseli üretin ya da fotoğraftan okuyun.

Ücretsiz pakette var JSON · Türkçe4 uç Kaynak: GS1 önek listesi, Open Food Facts, VeriApi.Pro hesaplaması

/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

ParametreTürAçıklama
kod* metin Barkod numarası
GET /v1/barkod/sorgula ücretsiz pakette 5 birim

Barkoddan ürün adı, marka, görsel, besin değerleri

ParametreTürAçı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)

ParametreTürAçı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)

ParametreTürAçı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