منصة HIOBuy المفتوحة

HIOBuy هي شريك تقني رسمي مفوض لكل من Taobao و1688 وWeidian. نربط مصادر التوريد الصينية بمنصتك عبر API موحد — ليس فقط بيانات المنتجات، بل المسار الكامل من مزامنة الكتالوج إلى الشراء الآلي و(اختياريا) التسليم الدولي.

ما الذي توفره HIOBuy

على عكس أدوات scraping العامة للأسواق أو خلاصات البيانات للقراءة فقط، صممت HIOBuy حول fulfillment شامل من البداية إلى النهاية. يجب أن يقود تكاملك معاملات حقيقية على واجهة متجرك ومن خلال Procurement APIs لدينا.

مخطط توضيحي (HIOBuy يربط المصادر الصينية بمنصتكم: مزامنة المنتجات، استلام الطلبات، الشراء التلقائي، ومزامنة الحالة)

تقع منصّة HIOBuy بين أسوق الصين التجارية وأعمالكم — لمزامنة المنتجات، واستلام الطلبات، والشراء الآلي، وإرجاع حالات التقدّم إلى لوحة التحكم.

القدرة	ماذا تعني لك
مزامنة المنتجات	البحث، التفاصيل، البحث بالصورة، SKU/stock/price من 1688 وTaobao وWeidian عبر /v1/products/*
استقبال الطلبات	يرسل الخادم الخلفي لديك طلبات العملاء إلى HIOBuy عند حدوث بيع على موقعك
الشراء الآلي	تنشئ HIOBuy الطلب المقابل على السوق المصدر عبر /v1/orders/*
مزامنة الحالة	تقدم الشراء واللوجستيات المحلية و(في وضع المستودع) التتبع الدولي تعود إلى أنظمتك — راجع Webhooks
الشحن الدولي	اختياري: شحن الطرود الواردة إلى المستودع خارجيا عبر /v1/fulfillment/* (وضع المستودع فقط)

كيف نختلف عن APIs الأخرى

• وصول رسمي للقنوات — تكاملات شركاء مفوضة، وليست scraping غير رسمية.
• موجه للمعاملات — توجد Product APIs لدعم sourcing وcheckout؛ وتكمل Procurement APIs حلقة الشراء.
• استجابات قياسية موحدة — مخطط واحد عبر 1688 وTaobao وWeidian؛ راجع تنسيق الاستجابة.
• Fulfillment كامل اختياري — وضع self للمشترين الذين يديرون لوجستياتهم؛ ووضع warehouse عندما يجب أن تخزن HIOBuy وتشحن دوليا.

الاستخدام المقبول والحصص {#acceptable-use}

الوصول إلى API ليس غير محدود. ترتبط الحصص وحدود المعدل باتفاقك التجاري وبـ حجم المعاملات المتوقع (GMV) عبر المنصة.

HIOBuy مخصصة للتكاملات التي يقود فيها اكتشاف المنتجات إلى طلبات حقيقية — يشتري العملاء على موقعك، ويستدعي الخادم الخلفي لديك /v1/orders/* للشراء. التطبيقات التي تستهلك بحث/تفاصيل المنتجات فقط دون نشاط شراء ذي معنى، أو التي تتجاوز HIOBuy في الشراء مع استخدام Catalog APIs لدينا، غير مدعومة وقد يتم تعليقها بعد المراجعة.

توثق ترويسات حدود المعدل التقنية وأكواد الأخطاء ضمن حدود المعدل. يتم الاتفاق على الشروط التجارية أثناء onboarding — ولا تكرر في صفحات نقاط النهاية الفردية.

تدفقات التكامل {#integration-flows}

اختر وضع fulfillment في بوابة المطورين عند تفويض تطبيقك. مسار Product API مشابه؛ يختلف الشراء والشحن الدولي.

Self fulfillment — أنت تدير الشراء

مناسب عندما تملك حسابات أسواق بالفعل وتدير التخزين بنفسك.

1. Product sync — 1688 / Taobao / Weidian → HIOBuy Gateway: البحث، التفاصيل، الصور، SKU، المخزون
2. Display — HIOBuy Gateway → واجهة متجرك
3. Customer order — عميلك → موقعك
4. Procurement — الخادم الخلفي لديك → HIOBuy Gateway: POST /v1/orders/preview → create → pay
5. Auto-purchase — HIOBuy Gateway → Marketplace (باستخدام OAuth الخاص بك)
6. Status return — Marketplace → HIOBuy Gateway: الشراء واللوجستيات المحلية
7. Dashboard sync — HIOBuy Gateway → لوحة التحكم لديك

الشحن الدولي (/v1/fulfillment/*) غير متاح في وضع self. أنت تتولى التسليم الخارجي بنفسك.

HIOBuy warehouse fulfillment — من البداية إلى النهاية

كود مستودع واحد يربط كل القنوات؛ تتولى HIOBuy الشراء والتخزين والشحن دوليا.

1. Product APIs — لا تزال تستدعي الأسواق مباشرة (زمن استجابة منخفض)
2. Product sync — إلى موقعك الموجه للعملاء
3. Customer order — على موقعك
4. Procurement — POST /v1/orders/* (يمرر إلى مستودع HIOBuy)
5. Auto-purchase — مستودع HIOBuy → Marketplace برموز مدارة
6. Inbound — تصل البضائع؛ parcel_nos في تفاصيل الطلب
7. International — freight/estimate → preview → create → pay
8. Delivery — التتبع عبر /v1/fulfillment/shipments/logistics/trace

تمر APIs الشراء والدولية عبر HIOBuy. تبقى Product APIs مباشرة إلى المنصات للسرعة.

مقارنة الأوضاع

	Self fulfillment	HIOBuy warehouse
Channel tokens	تدير OAuth لكل قناة	كود مستودع واحد يربط كل القنوات
/v1/products/*	Gateway → marketplace	Gateway → marketplace (مباشر، زمن استجابة منخفض)
/v1/orders/*	Gateway → marketplace (رموزك)	Gateway → HIOBuy warehouse API
/v1/fulfillment/*	غير متاح	شحن دولي + رصيد

كيف تصبح مطورا {#become-a-developer}

1. سجل باستخدام شركتك وموقعك وحالة الاستخدام (مثل purchasing agent أو cross-border store).
2. تحقق من بريدك الإلكتروني.
3. سجل الدخول وأنشئ App في بوابة المطورين — صف تكاملك وحجم الحركة المتوقع.
4. انتظر مراجعة HIOBuy. نعتمد التطبيقات المتوافقة مع sourcing القائم على المعاملات؛ وستحصل على الحصص وإتاحة القنوات تبعا لذلك.
5. بعد الاعتماد: فوض القنوات (OAuth ذاتي أو كود مستودع)، ثم أنشئ مفتاح API ضمن API Keys.
6. التكامل: تفاصيل المنتج → checkout العميل → procurement preview/create → pay → status webhooks. في وضع المستودع، أضف تدفق الشحن الدولي.

هل تحتاج إلى كود مطور مستودع؟ تواصل مع عمليات HIOBuy بعد اعتماد تطبيقك لـ warehouse fulfillment.

خريطة مرجع API

Base URL: https://api.hiobuy.com/v1

المجال	Prefix	Docs
Products	/v1/products/*	Products
Procurement	/v1/orders/*	طلبات الشراء
Fulfillment	/v1/fulfillment/*	الشحنات والرصيد

نوعان من الطلبات — لا تخلط بينهما: procurement (/v1/orders/*) يشتري من البائعين الصينيين إلى مستودع محلي؛ والشحنة الدولية (/v1/fulfillment/shipments/*) ترسل الطرود الواردة خارجيا.

ترتيب القراءة الموصى به {#reading-order}

1. كن مطورا — التسجيل، اعتماد التطبيق، مفتاح API
2. المصادقة + تفويض البوابة
3. Products → طلبات الشراء
4. اختياري: Fulfillment (وضع المستودع)
5. الأخطاء وحدود المعدل عند تقوية الإنتاج

نطاق Public API {#public-api-scope}

تصف هذه الوثائق سطح Public API المدعوم. قد تظهر بعض المسارات في openapi.json  للاستخدام الداخلي أو المهمل (مثل /v1/shipments القديم، ومسارات refund) — إذا لم تكن نقطة النهاية مدرجة هنا، فاعتبرها غير متاحة.

الأعراف التقنية {#technical-conventions}

• Auth: Authorization: Bearer YOUR_API_KEY — المصادقة
• Product language في جسم JSON — اللغات
• الأسعار: CNY yuan في المنتجات، وfen في الطلبات والشحنات
• response_format: "standard" (الافتراضي) أو "upstream" — تنسيق الاستجابة

مواصفة OpenAPI: api.hiobuy.com/openapi.json 

الوثائق المنشورة: hiobuy.com/api-docs