Cataref / product reference api
مرجع واحد لهوية المنتج
قد يصلك المنتج نفسه بأسماء وأحجام ومعرّفات مختلفة. يفصل Cataref بين العائلة والمتغير والوحدة التجارية لتستخدم المستوى المناسب من التفاصيل.
مشروب برتقال
Orange drink
قنينة · ١ لتر- الباركود / GTIN
- 9990000000012
- عائلة المنتج
- مشروب فاكهة
- المتغير
- برتقال
يربط المرجع الواحد الأسماء والمعرّف والوحدة الفعلية. القيم المعروضة للتوضيح.
المنتج نفسه. وحدات فعلية مختلفة.
- 1قنينة مفردة١ لتر · الوحدة التجاريةالوحدة الأساسية
- 6عبوة سداسيةتحتوي ٦ قناني مفردة٦ لترات إجمالاً
- 24كرتون خارجييحتوي ٤ عبوات سداسية٢٤ لتراً إجمالاً
تبقى علاقات العبوات وتحويلات المحتوى واضحة.
تتغير اللغة. ويبقى معرّف المنتج.
- English en
- Orange drink
- العربية ar
- مشروب برتقال
حدد اللغة المطلوبة وتحقق من لغة الاسم المسترجع، بما في ذلك اللغة البديلة عند عدم توفر الاسم المطلوب.
حقول توضيحية من الاستجابة
{
"display_name": {
"value": "Orange drink",
"locale": "en"
},
"package_type": "bottle",
"net_content": "1",
"content_unit": "L",
"identifiers": [
{
"scheme": "gtin",
"raw_value": "9990000000012"
}
]
}مقتطف توضيحي وليس طلباً مباشراً. راجع دليل المطورين للعقد الكامل.
GET /v1/identifiers/lookupاعرف المنتج المقصود
ابحث بمعرّفات GTIN ومعرّفات الجهات المُصدرة المطابقة تماماً. حافظ على ارتباط المتغيرات وكميات العبوات دون دمجها في سجل واحد.
احتفظ بالدليل مع المعلومة
تبقى المساهمات خاصة حتى المراجعة المستقلة. تحتفظ المعلومات المقبولة بسياق المصدر وضوابط الحقوق والتصحيحات المراجعة.
استخدم لغة كتالوجك
استرجع الأسماء العربية والإنجليزية والتصنيفات المترجمة، مع تحديد السوق واللغة في كل طلب.
اعرف تكلفة القراءة
قدّر تكلفة الطلبات، واستخدم مفاتيح محددة الصلاحيات، وتتبّع رصيد الاستخدام مع إيصال يميز القراءة الجديدة عن إعادة الطلب.
آخر تحديث:
استكشف مساحة عملك