OneCatalog API
توثيق واجهات OneCatalog العامة للمطوّرين. يغطّي هذا الموقع واجهتين:
| API | الغرض | التغطية في هذا التوثيق |
|---|---|---|
| Wiki API | بيانات مرجعية للمنتجات والعلامات التجارية والفئات والمجموعات والدول ووحدات القياس والمواصفات وأنواع المنتجات. | كاملة — جميع الطرق. |
| B2B API | منصّة B2B للموردين وتجّار التجزئة. | فقط الطريقة العامة «الأسعار والمخزون حسب المفتاح» (share-products/{url_key}). أمّا الطرق الأخرى فهي متاحة للشركاء المصرّح لهم وغير مُدرَجة هنا. |
عناوين القاعدة
| API | Base URL |
|---|---|
| Wiki | https://api.onecatalog.net/wiki |
| B2B | https://api.onecatalog.net/b2b |
ترجمة الاستجابات
تدعم كلتا الواجهتين استجابات متعدّدة اللغات عبر معامل الاستعلام lang. القيم المتاحة:
| الرمز | اللغة |
|---|---|
ru | الروسية (الافتراضية) |
en | الإنجليزية |
ar | العربية |
zh | الصينية |
kk | الكازاخية |
مثال:
curl "https://api.onecatalog.net/wiki/v1/products/?lang=en"
تتضمّن الاستجابات كتلة meta.i18n تبيّن اللغة المطبّقة فعليًّا ولغة الاحتياط (fallback).
المصادقة
- Wiki API — معظم الطرق عامة. للحصول على الحقول الموسّعة، مرّر مفتاح API في معامل الاستعلام
api-keyأو في الترويسةX-API-Key. - B2B API (share-products العامة) — الوصول عبر
url_keyالخاص بقائمة الأسعار؛ ويمكن عند الحاجة تمرير مفتاح إضافيprivate_keyكمعامل استعلام.
صيغة الاستجابة
تُعاد الاستجابات بصيغة JSON. تدعم كثير من طرق Wiki المعامل response_fmt (json، yaml، yml، xml) والتصدير كملف (is_download=1). يتم التقسيم إلى صفحات عبر start وlimit.
تلميح
يسرد قسما Wiki API وB2B API على اليسار كل طريقة مع معاملاتها ومخطّطات استجابتها وأمثلة الطلبات. ولكل طريقة زر لإرسال الطلب مباشرةً من التوثيق.