واجهة الموزعين
اربط موقعك أو البوت
اعرض المنتجات، وتحقق من الرصيد، واشترِ، وتابع الطلبات بمفتاح من حسابك.
المصادقة
أرسل المفتاح في الترويسة X-Api-Key. أنشئه من تبويب API في حسابك. المفتاح الكامل يظهر مرة واحدة فقط.
قائمة المنتجات
GET /api/v1/products
يعيد الدول المتاحة للبيع مع السعر الحالي والمخزون. صفِّ بـ tier=old أو tier=new، وcountry كرمز ISO أو معرف الدولة.
curl
curl "https://acceptororg.com/api/v1/products?tier=old&country=IT" \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/products?tier=new", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();الرصيد
GET /api/v1/balance
يعيد رصيد صاحب المفتاح بالدولار.
curl
curl https://acceptororg.com/api/v1/balance \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/balance", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();الشراء
POST /api/v1/buy
يخصم الرصيد وينشئ الطلب. أرسل ترويسة Idempotency-Key لإعادة المحاولة بأمان.
curl
curl https://acceptororg.com/api/v1/buy \
-H "X-Api-Key: acc_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{"country":"IT","tier":"old","quantity":1}'JavaScript
const res = await fetch("https://acceptororg.com/api/v1/buy", {
method: "POST",
headers: {
"X-Api-Key": "acc_your_key",
"Content-Type": "application/json",
"Idempotency-Key": "order-1001",
},
body: JSON.stringify({ country: "IT", tier: "old", quantity: 1 }),
});
const data = await res.json();حالة الطلب
GET /api/v1/orders/:id
يعيد حالة أحد طلباتك. عند وجود download_url اطلبه بنفس المفتاح. هو وسيطنا للتنزيل وليس عنوان المورد.
curl
curl https://acceptororg.com/api/v1/orders/ORDER_ID \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/orders/ORDER_ID", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();حد الطلبات
كل مفتاح يسمح بـ 60 طلبًا في الدقيقة ما لم يُضبط حد آخر. الطلبات الزائدة تعيد 429.
رموز الأخطاء
unauthorized
المفتاح مفقود أو غير معروف أو ملغى.
rate_limited
طلبات أكثر من الحد خلال هذه الدقيقة.
invalid_request
ينقص الحقل أو القيمة غير صالحة.
not_found
هذا الطلب لا يخص هذا المفتاح.
insufficient_balance
الرصيد لا يغطي الطلب.
out_of_stock
المخزون لا يكفي للكمية.
price_unavailable
هذه الدولة وهذا النوع غير معروضين للبيع.
price_increased
السعر المباشر أعلى من السعر المعروض. لم يُخصم شيء.
unverified
تعذر التحقق من المخزون المباشر. لم يُخصم شيء.
sourcing_failed
رفض المورد الطلب. أُعيد الرصيد.
idempotency_conflict
استُخدم Idempotency-Key هذا لطلب مختلف.
idempotency_in_progress
طلب بنفس Idempotency-Key ما زال قيد التنفيذ.
unavailable
قاعدة بيانات API غير جاهزة.