دليل تكامل API من AQNAB

يمكن للبائعين استخدام واجهة برمجة التطبيقات الموحدة لمزامنة الكتالوجات وإنشاء الطلبات وتتبع التقدم. لا تتضمن الوثائق العامة مفاتيح API؛ تُدفع الطلبات من رصيد حسابك. خزّن مفاتيح API الخاصة بك على الخادم.

مزامنة الخدمات وتقديم الطلبات

  1. استدعِ services للحصول على معرف الخدمة، وسعر الألف، والحد الأدنى والحد الأقصى للكمية، وعلامة إعادة التعبئة، وتنسيق الرابط.
  2. املأ الصفحة العامة أو رابط المحتوى المحدد بناءً على نوع الخدمة، ثم أرسل عبر الإضافة. سيقوم الطلب بإعادة التحقق من الكمية والرابط والرصيد.
  3. احفظ معرّف الطلب المُعاد من AQNAB، ثم استدعِ حالة الطلب لمعرفة الحالة الفعلية المتزامنة وعدد البدايات والعدد المتبقي.
  4. إذا انتهت مهلة الطلب أو كانت النتائج غير مؤكدة، تحقق أولاً من الطلب وتأكد منه يدويًا. لا تنتقل إلى مسار آخر وتعيد الإرسال مباشرة. فقط بعد التأكد من عدم قبول الطلب، يمكنك اختيار خدمة أخرى وإعادة الإرسال.

مثال بسيط للاستدعاء

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 لموقع فرعي مفتاحًا سريًا منفصلًا. تستخدم مفاتيح المواقع الفرعية رصيد الشراء الذي قمت بتحميله مسبقًا على موقع المورد هذا وتنشئ الطلبات بأسعار ذلك الموقع؛ ولا تستخدم أرصدة من مواقع أخرى أو من الموقع الرئيسي. إذا كان رصيد الشراء في أي مستوى غير كافٍ، يتم رفض الخصم بالكامل. تذهب إعادة شحن العملاء إلى حساب الاستلام المكوّن لموقع المورد ذلك.

واجهات نشر المدونات والأدلة والصور

واجهة نشر الوكيل تدعم إنشاء مسودة، معاينة، تعديل، نشر، قائمة وحذف، باستخدام مفتاح نشر مستقل، مقتصر على الموقع الرئيسي أو موقع فرعي محدد. يرجى اختبار المسودة قبل نشر المقال الرسمي.

عرض وثائق API الكاملة للوكيل وجدول الحقول →

إدارة المفاتيح

AQNAB API V2

وثائق واجهة برمجة التطبيقات للمطورين

احصل على معرف الخدمة وسعر الحساب الحالي من كتالوج الخدمات، ثم استخدم نفس المفتاح لتقديم الطلبات والتحقق منها.

طريقة 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، مفصولة بفواصل.
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
مثال على استجابة ناجحة
{
  "refill": "AQR-EXAMPLE"
}

تقدم التعويض refill_status

أعد Pending أو Completed أو Rejected أو Pending review. يمكن إرسال refills بكميات من 1 إلى 100 رقم تعويض.

المعلماتالنوعالوصف
keyسلسلة نصيةمطلوب. أدخل AQNAB API Key الخاص بك.
actionسلسلة نصية必填。固定为 refill_status。
refillسلسلة نصيةالمعرف الذي يتم إرجاعه عند طلب التعويض؛ للطلبات المجمعة استخدم refills.
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
مثال على استجابة ناجحة
{
  "status": "Pending"
}

طلب إلغاء cancel

يدعم فقط الطلبات غير النهائية مع cancel=true. إرجاع 1 يعني أن الطلب في قائمة الانتظار، ولا يعني أنه تم إلغاؤه أو استرداده. تابع حالة الطلب.

المعلماتالنوعالوصف
keyسلسلة نصيةمطلوب. أدخل AQNAB API Key الخاص بك.
actionسلسلة نصية必填。固定为 cancel。
ordersسلسلة نصية1–100 رقم طلب، مفصولة بفواصل.
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
مثال على استجابة ناجحة
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

قائمة الخدمات services

أعد كتالوج المبيعات المتاح للحساب الحالي. استخدم سلسلة service للطلب؛ rate هو سعر البيع بالدولار لكل 1,000 وحدة. عند ظهور required، مرر معاملات الطلب وفقًا لتلك القائمة. تشير علامتا refill / cancel إلى ما إذا كان المنتج يدعم طلب التعويض والإلغاء.

المعلماتالنوعالوصف
keyسلسلة نصيةمطلوب. أدخل AQNAB API Key الخاص بك.
actionسلسلة نصية必填。固定为 services。
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
مثال على استجابة ناجحة
[
  {
    "service": "AQ1-123",
    "name": "TikTok 粉丝",
    "type": "Default",
    "category": "TikTok - 粉丝",
    "rate": "0.900",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false
  },
  {
    "service": "AQ2-456",
    "name": "TikTok 自定义评论",
    "type": "Custom Comments",
    "category": "TikTok - 评论",
    "rate": "8.00",
    "min": 1,
    "max": 100,
    "refill": false,
    "cancel": false,
    "required": [
      "link",
      "comments"
    ]
  }
]

التحقق من الرصيد balance

إرجاع الرصيد المتاح لحساب مفتاح 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 حرف؛ الخدمات الأخرى لا تحتاجه.
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
مثال على استجابة ناجحة
{
  "order": "API-EXAMPLE-4ABC"
}
مثال لطلب تعليقات وكلمات مفتاحية مخصصة
تعليقات مخصصة
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
كلمات مفتاحية مخصصة
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

التحقق من حالة الطلب status

يمكنك الاستعلام عن طلبات حسابك الحالي فقط. مرر orders لاستعلام دفعة يصل إلى 100 طلب (مفصولة بفواصل)، وتُرجع النتائج مفهرسة حسب رقم الطلب. الحالات تشمل: Pending، In progress، Completed، Partial، Canceled. start_count و remains تأتي من مزامنة حالة المورد؛ تكون null إذا لم تُرجع بعد. حالة المورد ليست دليلًا مستقلًا على التسليم الفعلي.

المعلماتالنوعالوصف
keyسلسلة نصيةمطلوب. أدخل AQNAB API Key الخاص بك.
actionسلسلة نصية必填。固定为 status。
orderسلسلة نصيةمطلوب. حقل الطلب الذي يتم إرجاعه عند إنشاء الطلب.
محتوى الطلب (JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
مثال على استجابة ناجحة
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

معالجة الأخطاء

حالة HTTPالوصف
400معلمات غير صالحة، أو الخدمة غير متاحة، أو الرصيد غير كافٍ.
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 وصيغة الرابط المعادين، ولا تخمّن الأرقام.

كتالوج الخدمات · دليل API المفصل · موقع فرعي بعلامة بيضاء