البدء السريع

1. احصل على بيانات الاعتمادنسخ رابط القسم

أنشئ مفتاح API شخصيًا من الحساب ← الإحالات ← مفاتيح API. انسخه عند ظهوره ومرّره إلى السكربت الخاص بك باسم NINJABUY_API_KEY، واحتفظ به سرًّا.

إذا كان تطبيقك يعمل نيابةً عن عملاء NinjaBuy آخرين، فاستخدم OAuth.

2. أنشئ روابط باستجابة فوريةنسخ رابط القسم

curl -sS https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://weidian.com/item.html?itemID=7581746714"],"campaign":"spring-haul","label":"video 3"}'

حتى 100 مُدخل تُرجع 200 مع results وwarnings وrequest_id. لكل نتيجة input وstatus، والنتيجة ok تتضمن url المنسوب إلى حسابك وcode. تحقّق من كل صف: نجاح طلب HTTP لا يعني أن كل المُدخلات قد حُوّلت. راجع الروابط.

3. ابدأ دفعةنسخ رابط القسم

عند تجاوز 100 مُدخل، تعمل المعالجة تلقائيًا في الخلفية، بحد أقصى 2,000 لكل طلب. لتجربة مهمة برابط واحد، اضبط async على true:

curl -sS -D batch-headers.txt https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://www.ninjabuy.com/search?q=hoodie"],"async":true}'

تكون الاستجابة 202. يعطي Location مسارًا نسبيًا مثل /api/v1/jobs/JOB_ID، ويحدد Retry-After: 5 متى تستعلم عن الحالة. ويحتوي جسم الاستجابة على job.id وjob.status وjob.total وjob.poll_after_seconds.

4. اقرأ النتائج باستخدام المؤشرنسخ رابط القسم

استخدم معرّف المهمة الوارد في تلك الاستجابة. احذف cursor في الطلب الأول:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

في كل طلب لاحق، مرّر المؤشر غير الفارغ المُعاد كما هو دون تعديل:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID?cursor=RETURNED_CURSOR" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

اقرأ results في كل صفحة. عندما تكون قيمة has_more هي true، اجلب الصفحة التالية. وعندما تكون false لكن المهمة لا تزال queued أو running، انتظر مدة poll_after_seconds ثم استعلم مجددًا بالمؤشر المحفوظ. توقّف بعد أن تصبح المهمة done أو failed وتُقرأ جميع الصفحات. راجع المهام والأخطاء.

الخطوات التاليةنسخ رابط القسم

حوّل جدول Google Sheets أو ملف XLSX/CSV مرفوعًا باستخدام الجداول، أو ابحث عن المنتجات باستخدام البحث.