ডেভেলপার

ডেভেলপার API

একটি পরিচ্ছন্ন REST API এবং একটিমাত্র কী দিয়ে নম্বর কেনা ও OTP কোড আনার কাজ স্বয়ংক্রিয় করুন।

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 টোকেন ব্যবহার করুন।