يمكن للبائعين استخدام واجهة برمجة التطبيقات الموحدة لمزامنة الكتالوجات وإنشاء الطلبات وتتبع التقدم. لا تتضمن الوثائق العامة مفاتيح API؛ تُدفع الطلبات من رصيد حسابك. خزّن مفاتيح API الخاصة بك على الخادم.
مزامنة الخدمات وتقديم الطلبات
استدعِ services للحصول على معرف الخدمة، وسعر الألف، والحد الأدنى والحد الأقصى للكمية، وعلامة إعادة التعبئة، وتنسيق الرابط.
املأ الصفحة العامة أو رابط المحتوى المحدد بناءً على نوع الخدمة، ثم أرسل عبر الإضافة. سيقوم الطلب بإعادة التحقق من الكمية والرابط والرصيد.
احفظ معرّف الطلب المُعاد من AQNAB، ثم استدعِ حالة الطلب لمعرفة الحالة الفعلية المتزامنة وعدد البدايات والعدد المتبقي.
إذا انتهت مهلة الطلب أو كانت النتائج غير مؤكدة، تحقق أولاً من الطلب وتأكد منه يدويًا. لا تنتقل إلى مسار آخر وتعيد الإرسال مباشرة. فقط بعد التأكد من عدم قبول الطلب، يمكنك اختيار خدمة أخرى وإعادة الإرسال.
مثال بسيط للاستدعاء
curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'
API: POST /api/v2؛ يقبل نموذجًا أو JSON، ويعيد JSON. استعلام الرصيد action=balance؛ تقديم الطلب action=add، مرر الخدمة والرابط والكمية؛ استعلام التقدم action=status، مرر الطلب. للتعليقات المخصصة، مرر أيضًا comments؛ لخدمات الكلمات المفتاحية، مرر أيضًا keywords.
التعويض والإلغاء وشراء من الفروع
يدعم status استعلامًا جماعيًا للطلبات (حتى 100 طلب)؛ يقبل refill طلبًا أو طلبات، ويقبل refill_status إعادة تعبئة أو إعادة تعبئة، ويقبل cancel طلبات. لا يتم قبول إعادة التعبئة والإلغاء إلا عندما يدعمها الخدمة؛ تدخل الطلبات في قائمة انتظار غير متزامنة، ولا يعني طلب الإلغاء أنه تم إصدار استرداد.
توفر كل صفحة وصول API لموقع فرعي مفتاحًا سريًا منفصلًا. تستخدم مفاتيح المواقع الفرعية رصيد الشراء الذي قمت بتحميله مسبقًا على موقع المورد هذا وتنشئ الطلبات بأسعار ذلك الموقع؛ ولا تستخدم أرصدة من مواقع أخرى أو من الموقع الرئيسي. إذا كان رصيد الشراء في أي مستوى غير كافٍ، يتم رفض الخصم بالكامل. تذهب إعادة شحن العملاء إلى حساب الاستلام المكوّن لموقع المورد ذلك.
واجهات نشر المدونات والأدلة والصور
واجهة نشر الوكيل تدعم إنشاء مسودة، معاينة، تعديل، نشر، قائمة وحذف، باستخدام مفتاح نشر مستقل، مقتصر على الموقع الرئيسي أو موقع فرعي محدد. يرجى اختبار المسودة قبل نشر المقال الرسمي.
احصل على معرف الخدمة وسعر الحساب الحالي من كتالوج الخدمات، ثم استخدم نفس المفتاح لتقديم الطلبات والتحقق منها.
طريقة HTTP
POST
نقطة نهاية API
https://aqnab.com/api/v2
تنسيق الطلب
JSON أو نموذج (application/x-www-form-urlencoded)
تنسيق الاستجابة
JSON · وحدة التسعير USD
طريقة التحقق
إرسال في محتوى الطلبkey. يتم حفظ المفتاح على الخادم فقط.
طلب إعادة تعبئة refill
يتم دعم الطلبات التي تحمل علامة refill=true والتي تم إرسالها بالفعل إلى المورد فقط. تدخل الطلبات في قائمة انتظار أولاً؛ إذا كان رد المورد غير واضح، فانتظر التحقق ولا تعيد الإرسال. يمكنك إرسال ما يصل إلى 1–100 رقم طلب في حقل الطلبات.
المعلمات
النوع
الوصف
key
سلسلة نصية
مطلوب. أدخل AQNAB API Key الخاص بك.
action
سلسلة نصية
必填。固定为 refill。
order
سلسلة نصية
معرف طلب واحد؛ للدفعات استخدم orders، مفصولة بفواصل.
أعد كتالوج المبيعات المتاح للحساب الحالي. استخدم سلسلة service للطلب؛ rate هو سعر البيع بالدولار لكل 1,000 وحدة. عند ظهور required، مرر معاملات الطلب وفقًا لتلك القائمة. تشير علامتا refill / cancel إلى ما إذا كان المنتج يدعم طلب التعويض والإلغاء.
إرجاع الرصيد المتاح لحساب مفتاح API الحالي. الرصيد عبارة عن سلسلة نصية تحتوي على 4 منازل عشرية.
المعلمات
النوع
الوصف
key
سلسلة نصية
مطلوب. أدخل AQNAB API Key الخاص بك.
action
سلسلة نصية
必填。固定为 balance。
محتوى الطلب (JSON)
{
"key": "YOUR_KEY",
"action": "balance"
}
مثال على استجابة ناجحة
{
"balance": "12.5000",
"currency": "USD"
}
إنشاء طلب add
أنشئ طلبًا حقيقيًا واقتطع الرصيد. المبلغ الإجمالي = الكمية ÷ 1,000 × السعر الحالي لكل ألف، مقربًا إلى أربع منازل عشرية. احفظ رقم الطلب بعد استلامه للاستعلام لاحقًا. إذا انتهت مهلة الطلب، تحقق أولاً من الطلب في لوحة التحكم لتجنب التكرار.
المعلمات
النوع
الوصف
key
سلسلة نصية
مطلوب. أدخل AQNAB API Key الخاص بك.
action
سلسلة نصية
必填。固定为 add。
service
سلسلة نصية
مطلوب. استخدم معرّف الخدمة الذي يعيده services، مثل AQ1-123.
link
سلسلة نصية
مطلوب. رابط هدف متاح للعموم ببروتوكول http أو https.
quantity
عدد صحيح
مطلوب للخدمات القياسية، ويجب أن يكون بين الحد الأدنى والحد الأقصى. تُحتسب التقييمات المخصصة حسب الأسطر الصالحة.
comments
سلسلة نصية
التعليقات المخصصة إلزامية، سطر واحد لكل تعليق، بحد أقصى 20,000 حرف إجمالاً؛ الأسطر الفارغة لا تُحتسب في العدد.
keywords
سلسلة نصية
إلزامي للخدمات التي تتطلب كلمات مخصصة، بحد أقصى 2,000 حرف؛ الخدمات الأخرى لا تحتاجه.
يمكنك الاستعلام عن طلبات حسابك الحالي فقط. مرر orders لاستعلام دفعة يصل إلى 100 طلب (مفصولة بفواصل)، وتُرجع النتائج مفهرسة حسب رقم الطلب. الحالات تشمل: Pending، In progress، Completed، Partial، Canceled. start_count و remains تأتي من مزامنة حالة المورد؛ تكون null إذا لم تُرجع بعد. حالة المورد ليست دليلًا مستقلًا على التسليم الفعلي.
معلمات غير صالحة، أو الخدمة غير متاحة، أو الرصيد غير كافٍ.
401
المفتاح غير صالح أو تم إلغاؤه.
404
لا يمكن العثور على طلبات للحساب الحالي.
500 / 502
الخدمة غير متاحة حاليًا. إذا فشل طلب الطلب، يرجى التحقق من الطلب والرصيد أولاً.
مثال على استجابة الخطأ
{
"error": "Insufficient funds"
}
مثال على نموذج cURL
curl -X POST https://aqnab.com/api/v2 \
--data-urlencode "key=YOUR_KEY" \
--data-urlencode "action=services"
登录后管理下单密钥. يتم إنشاء مفتاح النشر بشكل مستقل من قبل مدير الموقع في قسم تحسين محركات البحث ويتم تسليمه بشكل آمن.
الأسئلة الشائعة
ما العمليات التي تتيحها API؟
تدعم /api/v2 العمليات services وbalance وadd وstatus. تتيح مزامنة الخدمات قراءة أسعار البيع الحالية وحدود الكمية. تنشئ add طلباً مدفوعاً فعلياً، وتعرض status التقدم بعد تحديثه من المورد.
هل يمكن تبديل الخدمة فور حدوث انتهاء مهلة؟
لا. قد يكون المورد قد استلم الطلب بالفعل. يجب الاستعلام عن الطلب الأصلي والتحقق منه يدوياً قبل تقرير إنشاء طلب جديد. لا يغيّر النظام المسار تلقائياً ولا يكرر الشراء عندما تكون نتيجة الإرسال غير مؤكدة.
كيف أحصل على مفتاح API؟
بعد تسجيل الدخول، أنشئ مفتاحاً للطلبات من مركز ربط API وفق شروط الحساب. يستخدم نشر المقالات مفتاح نشر مستقلاً يمكن تقييده بلوحة محددة، ولا يمكن استخدامه لإنشاء طلبات مدفوعة.
هل يمكن للوكلاء نشر المقالات مباشرة؟
يمكن إنشاء مسودة عبر API للنشر، ثم مراجعة المعاينة وتحديث الحالة إلى published. تدعم الواجهة عرض القائمة والتعديل والحذف ورفع الصور. راجع الوثائق لمعرفة جميع الحقول وحدود تكرار الطلبات.
لماذا لا يمكن استبدال ID الخدمة عشوائياً؟
يرتبط كل ID بخدمة ومسار توريد محددين. قد تختلف الأسعار والوجهة وحدود الكمية وشروط الدعم. زامن الكتالوج أولاً واستخدم ID وصيغة الرابط المعادين، ولا تخمّن الأرقام.