GTIP Açıklama ile Ara

GTİP Açıklama ile Arama

Bu servis, verilen bir anahtar kelimeye göre GTİP açıklamaları üzerinden arama yaparak, eşleşen GTİP kayıtlarını döndürür. Ürün adı ya da tanım içeriklerinden arama yaparak doğru GTİP koduna erişim sağlanmasına yardımcı olur.

Endpoint Bilgileri

  • URL: {{APP_URL}}/api/v1/gtip/search/description/{keyword}
  • HTTP Metodu: GET
  • İçerik Türü: application/json
  • Kimlik Doğrulama Tipi: APIKEY

İstek Parametreleri

Path Parametreleri

Parametre Adı Parametre Tipi Zorunluluk Açıklama
keyword String Zorunlu Aranacak anahtar kelime (kelimenin açıklama içinde geçmesi gerekir).

Örnek Kullanım

API İsteği

Bu örnekte, "alabalık" kelimesi GTİP açıklamalarında aranır ve alabalık ile ilgili tüm GTİP kodları dönülür.

GET {{APP_URL}}/api/v1/gtip/search/description/alabalık
Content-Type: application/json
APIKEY: {{APIKEY}}

API Cevabı

{
    "status": true,
    "message": null,
    "data": [
        {
            "id": "1277",
            "code": "030314",
            "description": "Balıklar (dondurulmuş)  (0304 pozisyonundaki balık filetoları ve > Alabalıklar  Salmo trutta, Oncorhynchus mykiss, Oncorhynchus clarki, Oncorhynchus aguabonita, Oncorhynchus gilae, Oncorhynchus  apache ve Oncorhynchus chrysogaster",
            "description_en": "Balıklar (dondurulmuş)  (0304 pozisyonundaki balık filetoları ve > Trout  Salmo trutta, Oncorhynchus mykiss, Oncorhynchus clarki, Oncorhynchus aguabonita, Oncorhynchus gilae, Oncorhynchus apache and Oncorhynchus chrysogaster :"
        },
        {
            "id": "1504",
            "code": "030442",
            "description": "Balık filetoları ve diğer balık etleri (kıyılmış olsun olmasın) (taze, > Alabalık  Salmo trutta, Oncorhynchus mykiss, Oncorhynchus clarki, Oncorhynchus aguabonita, Oncorhynchus gilae, Oncorhynchus apache ve Oncorhynchus chrysogaster :",
            "description_en": "Balık filetoları ve diğer balık etleri (kıyılmış olsun olmasın) (taze, > Trout  Salmo trutta, Oncorhynchus mykiss, Oncorhynchus clarki, Oncorhynchus aguabonita, Oncorhynchus gilae, Oncorhynchus apache and Oncorhynchus chrysogaster :"
        }
        // Diğer sonuçlar...
    ]
}

Not: description alanında aranan anahtar kelime büyük/küçük harf duyarlı olmaksızın aranır. data alanında eşleşen kayıtlar listelenir. Yanıt Özeti: Anahtar kelime, GTİP açıklamasında geçen tüm ürünler için ilgili kodlar ve tanımlar listelenir. Tanımlar hem Türkçe hem İngilizce olarak sunulur.

Hata Cevapları

{
    "status": false,
    "errors": [
        {
            "message": "invalid description data"
        }
    ]
}