المطورون

API للمطورين

أتمِت شراء الأرقام وجلب رموز OTP باستخدام واجهة REST API نظيفة ومفتاح واحد.

Base URLhttps://xthonvirtual.store/api/v2

المصادقة

أرسل مفتاح API الشخصي الخاص بك في ترويسة مع كل طلب. احصل عليه من البوت ضمن 🔑 API.

X-API-Key: YOUR_API_KEY

تحقّق من رصيدك، ثم: اعرض الخدمات ← اشترِ رقمًا ← استعلِم عن الرمز.

curl -X GET "https://xthonvirtual.store/api/v2/balance" \
  -H "X-API-Key: YOUR_API_KEY"

GET/balance

احصل على رصيدك الحالي ومستوى مكافأتك.

curl -X GET "https://xthonvirtual.store/api/v2/balance" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": { "balance": "12.50", "bonus": 10 }
}

GET/services

اعرض الخدمات النشطة مع أسعارها ومخزونها المباشر.

curl -X GET "https://xthonvirtual.store/api/v2/services" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": [
    { "id": "8f3c…", "name": "Telegram", "price": "1.20", "stock": 42 }
  ]
}

POST/services/{service_id}/buy

احجز واشترِ رقمًا واحدًا من خدمة.

curl -X POST "https://xthonvirtual.store/api/v2/services/{service_id}/buy" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": {
    "id": "tx_91a…", "status": "PENDING",
    "price": "1.20", "number": "+15550001", "code": null
  }
}

GET/transactions/{id}

اجلب معاملة (رقمًا) تملكها.

curl -X GET "https://xthonvirtual.store/api/v2/transactions/{id}" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": { "id": "tx_91a…", "status": "PENDING", "number": "+15550001", "code": null }
}

GET/transactions/{id}/code

استعلِم عن رمز OTP — يُعيد null حتى وصوله.

curl -X GET "https://xthonvirtual.store/api/v2/transactions/{id}/code" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": { "id": "tx_91a…", "status": "SUCCEEDED", "code": "54321" }
}

POST/transactions/{id}/cancel

استرد قيمة رقم قيد الانتظار (PENDING) لم يستقبل رمزًا أبدًا.

curl -X POST "https://xthonvirtual.store/api/v2/transactions/{id}/cancel" \
  -H "X-API-Key: YOUR_API_KEY"

الاستجابة

{
  "ok": true,
  "data": { "refunded": "1.20" }
}

تشتري بكميات كبيرة؟ استخدم رموز API لشراء الأرقام بالجملة برمجيًا، مع أفضل سعر للوحدة ودعم مخصّص للموزّعين.