هذا طلب يُرسل عبر API:
POST /api/v2
key=YOUR_API_KEY
action=add
service=645
link=https://www.instagram.com/p/EXAMPLE/
quantity=5000
{ "order": 23501 }
طلب واحد، ورقم طلب واحد في الرد. كل ما يفعله موقع الموزّع مبني من بضعة طلبات مثل هذا. كل واحد منها طلب POST عبر HTTP يرسل مفتاح API الخاص بك ومعه action، وكل واحد يردّ بصيغة JSON.
الطلبات الأربعة التي تحتاجها
services يعيد القائمة كلها. في كل عنصر: service (المعرّف)، name، category، rate، min، max، وعلامتان: refill وcancel. موقعك يقرأ هذا ليبني قائمة أسعاره.
add يرسل طلباً. يأخذ service وlink وquantity. وللتسليم المتدرّج أضف runs وinterval (بالدقائق).
status يخبرك أين وصل الطلب:
{
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD"
}
start_count هو العدد على الصفحة حين بدأ الطلب. remains هو ما لم يُسلَّم. charge هو ما كلّفك الطلب. ولتفحص طلبات كثيرة في مرة واحدة أرسل orders وفيه المعرّفات مفصولة بفواصل.
balance يعيد رصيدك، مثلاً {"balance": "100.84292", "currency": "USD"}. افحصه قبل أن تقبل طلب العميل لا بعده.
طلبان آخران لما بعد التسليم
refill يطلب تعويضاً لطلب ويعيد معرّف التعويض. refill_status يخبرك هل تمّ: Completed أو Rejected. cancel يأخذ حتى 100 معرّف طلب في مرة واحدة، ويعمل فقط مع الخدمات التي علامة cancel فيها true.
الترتيب الذي تربطها به
- زامن الخدمات بجدول منتظم. الأسعار تتغير. قائمة أسعار نُسخت مرة واحدة تصير خاطئة خلال شهر.
- أضف هامشك حين تخزّن كل سعر، حتى لا يعرض موقعك سعر المزوّد بالخطأ.
- افحص
minوmaxعندك قبل أن ترسل الطلب. طلب مرفوض بعد أن دفع العميل يعني تذكرة. - أرسل الطلب حين يغطّيه رصيد العميل، واحفظ رقم الطلب الذي يعود إليك.
- استعلم عن
statusإلى أن يصير الطلبCompletedأوPartial. وفي حالةPartialأعد إلى العميل قيمة ما لم يُسلَّم.
أبقِ المفتاح على خادمك
مفتاح API ينفق من رصيدك. مكانه متغيرات البيئة على خادمك، لا صفحة ويب ولا تطبيق ولا مستودع عام. إذا تسرّب فاستبدله من حسابك قبل أي شيء آخر.
ما الذي لا يخبرك به API
لا يخبرك هل سيثبت العدد. هذا شأن مدة التعويض في سطر الخدمة، ولا تعرفه إلا بالطلب. انظر كيف تقرأ سطر الخدمة.