Acceptor_org
تسجيل الدخول

واجهة الموزعين

اربط موقعك أو البوت

اعرض المنتجات، وتحقق من الرصيد، واشترِ، وتابع الطلبات بمفتاح من حسابك.

API

المصادقة

أرسل المفتاح في الترويسة 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 غير جاهزة.