API Servisleri

Ürünler - Products

Bu API servisi ürün bilgilerine erişmenizi sağlar. Ürün kodu, adı, birimi, tipi, grubu gibi alanları içerir. Gelişmiş filtreleme ve dil desteği sunar.

Temel URL

Sunucu ortamına göre değişkendir: 

https://{host}/pls/{app}/products

Not: {host} ve {app} alanlarını kendi sisteminize göre güncelleyin.

İstek Metodu

GET

Sorgu Parametreleri

ParametreTipKullanımAçıklamaÖrnek
apikey string Gerekli Sisteme ait API anahtarınız xxxxxxxxxxxxxxxxxxxxxxxxxxxx
lang string İsteğe bağlı Dil kodu. Seçenekler: TR, EN, DE. Varsayılan: TR EN
productcode string İsteğe bağlı Ürün kodu veya filtreleme ifadesi A1000, A1000~GT, A1000~RNG~A3000
addbeg tarih İsteğe bağlı Ürün ekleme başlangıç tarihi (YYYY-MM-DD) 2024-01-01
addend tarih İsteğe bağlı Ürün ekleme bitiş tarihi 2025-01-01
updbeg tarih İsteğe bağlı Ürün güncelleme başlangıç tarihi 2025-01-01
updend tarih İsteğe bağlı Ürün güncelleme bitiş tarihi 2025-12-31
maxrec integer İsteğe bağlı Getirilecek maksimum kayıt sayısı. Varsayılan: 1000 100

productcode için Filtreleme Notasyonu

NotasyonAnlamıÖrnek
ABC123Tam eşleşmeproductcode=ABC123
ABC~LKABC ile başlayanlarproductcode=ABC~LK
ABC~NLKABC ile başlamayanlarproductcode=ABC~NLK
ABC~GTABC ile başlayanlardan büyük olanlarproductcode=ABC~GT
ABC~GTEABC ile başlayanlardan büyük veya eşit olanlarproductcode=ABC~GTE
ABC~LTABC ile başlayanlardan küçük olanlarproductcode=ABC~LT
ABC~LTEABC ile başlayanlardan küçük veya eşit olanlarproductcode=ABC~LTE
ABC~RNG~XYZABC ile XYZ başlayanların arasındakilerproductcode=ABC~RNG~XYZ
A1000,B2000,C3000Liste içindekilerproductcode=A1000,B2000

Örnek İstek

GET https://sys.nixla.com/pls/web/products?apikey=xxxxxxxxxxxxxxxxxxxxxxxxxx&lang=TR&productcode=A1000~LK

Örnek Yanıt

[
  {
    "productID": "VM944019",
    "productCode": "AIR_01",
    "productName": "Air Pods 3. Nesil",
    "productName2": null,
    "uomCode": "EACH",
    "uomName": "Tane",
    "objTypeCode": "TRG",
    "objTypeName": "Ticari Mal",
    "productTypeCode": "GNL",
    "productTypeName": "Genel",
    "productGroupCode": "ADV",
    "productGroupName": "Tanıtım / Reklam Malzemesi",
    "productCatCode": null,
    "productCatName": null,
    "addDate": "2015-01-01",
    "updDate": "2025-07-23"
  }
]

Notlar

  • Tüm karşılaştırmalar büyük/küçük harf duyarsızdır (Oracle NLS).
  • Hiçbir parametre verilmezse, ilk 1000 kayıt döner.
  • Yanıt JSON dizisi şeklindedir, her bir nesne bir ürünü temsil eder.

Hata Kodları

  • 401 Yetkisiz - Geçersiz veya eksik API anahtarı
  • 400 Hatalı İstek - Geçersiz tarih veya filtre formatı
  • 500 Sunucu Hatası - Dahili hata

İletişim

API erişimi veya teknik destek için: support@nixla.com
Bilgi Talebi