02 / مثال عملي
مثال عملي
مثال: ناشر بسعر رصيدين شهريًا يكلف 6 أرصدة لثلاثة أشهر. المفتاح ذو الحد اليومي 5 يعيد DAILY_CREDIT_LIMIT. الحد 6 يسمح بالطلب إذا كان البريد موثقًا والرصيد والمخزون كافيين. تكرار الطلب المقبول بنفس UUID لا يحجز أرصدة إضافية.
واجهة API للروابط الخلفية
اربط نظامك بكتالوج الناشرين وطلبات الروابط الخلفية ومراقبة الروابط المحفوظة. أنشئ الطلب وحدد الصلاحيات وتابع النتيجة الفعلية في حسابك.
أنشئ طلب API الخاص بك
دون خصم أرصدة
أرسل المفتاح في ترويسة Authorization: Bearer عبر HTTPS. احتفظ به على الخادم لا في كود المتصفح العام أو الروابط. تقرأ الأمثلة API_KEY من البيئة.
curl --fail-with-body --request GET 'https://panel.starbacklink.com/api/v1/credits' \
--header "Authorization: Bearer ${API_KEY}"أرسل المفتاح في ترويسة Authorization: Bearer عبر HTTPS. احتفظ به على الخادم لا في كود المتصفح العام أو الروابط. تقرأ الأمثلة API_KEY من البيئة.
60 طلبًا لكل مفتاح في الدقيقة و120 لكل حساب في الدقيقة و10,000 لكل حساب في يوم UTC. الإجماليات لآخر 30 يومًا؛ تُحفظ آخر 500 سجّل لكل مفتاح لمدة أقصاها 30 يومًا.
تُخفى أسماء الكتالوج ونطاقاته عندما يكون الرصيد صفرًا. تبقى تفاصيل ناشري روابطك المدفوعة مرئية. المقاييس ملاحظات المورّد وليست تقارير تحليل جديدة.
تعني HTTP 202 قبول الطلب للمعالجة لا نشره. راجع الطلب أو المراقبة لمعرفة النتيجة الحالية.
لا تعيد المبالغ المستردة عداد الإنفاق اليومي إلى الصفر. تُحفظ الاستجابات المقبولة لإعادة المحاولة بأمان دون خصم جديد.
توفر API بيانات حسابك وتفحص أزواج المصدر والوجهة المعروفة. لا تكتشف كل الروابط الخلفية في الويب ولا توفر فهرس روابط لطرف ثالث.
01
طريقة الاستخدام
- 01
أنشئ مفتاحًا من قسم واجهة المطورين. ابدأ بصلاحيات قراءة الرصيد والفهرس والطلبات والمراقبة. حدد انتهاء الصلاحية واحفظ السر على خادمك.
- 02
اختر العملية ولغة البرمجة. للطلب المدفوع، انسخ معرّف الناشر وسعره الحالي من الفهرس، ثم اختر عدد الأشهر وراجع التكلفة.
- 03
لكل عملية كتابة، احفظ UUID مع نص الطلب نفسه. أرسل الطلب من خادمك واحفظ الرد، ثم راجع الطلب أو سجل المراقبة لمعرفة تقدمه.
03 / كيفية قراءة النتائج
كيفية قراءة النتائج
60 طلبًا لكل مفتاح في الدقيقة و120 لكل حساب في الدقيقة و10,000 لكل حساب في يوم UTC. الإجماليات لآخر 30 يومًا؛ تُحفظ آخر 500 سجّل لكل مفتاح لمدة أقصاها 30 يومًا. توفر API بيانات حسابك وتفحص أزواج المصدر والوجهة المعروفة. لا تكتشف كل الروابط الخلفية في الويب ولا توفر فهرس روابط لطرف ثالث.
الأسئلة الشائعة
هل تكتشف الواجهة جميع الروابط الخلفية لأي نطاق؟
توفر API بيانات حسابك وتفحص أزواج المصدر والوجهة المعروفة. لا تكتشف كل الروابط الخلفية في الويب ولا توفر فهرس روابط لطرف ثالث. تُخفى أسماء الكتالوج ونطاقاته عندما يكون الرصيد صفرًا. تبقى تفاصيل ناشري روابطك المدفوعة مرئية. المقاييس ملاحظات المورّد وليست تقارير تحليل جديدة.
كيف أتجنب الخصم المكرر؟
اختر UUID لكل عملية كتابة جديدة وأعد استخدامه عند المحاولة مجددًا. الطلب الناجح نفسه يعيد النتيجة الأصلية؛ بيانات مختلفة مع UUID نفسه تعيد 409. استعلم عن الطلب لمعرفة حالته الحالية. لا تعيد المبالغ المستردة عداد الإنفاق اليومي إلى الصفر. تُحفظ الاستجابات المقبولة لإعادة المحاولة بأمان دون خصم جديد.