Dedibot API v1

مستندات API

خرید، تمدید، لینک تست، و تمام عملیات پنل مدیریت لینک از طریق HTTP.

Base URL: https://api.example.com

احراز هویت: Authorization: Bearer YOUR_API_TOKEN

کاتالوگ

GET /v1/servers

لیست سرورها با index برای خرید.

GET /v1/plans?month=1

پلن‌های ۱/۲/۳ ماهه با قیمت بعد از تخفیف حساب.

GET /v1/protocols

کلیدهای پروتکل برای تغییر نوع لینک.

GET /v1/sni

لیست SNIهای Reality.

حساب

GET /v1/ping
GET /v1/me
GET /v1/balance
GET /v1/links

خرید / تست / تمدید

POST /v1/buy

{
  "server_index": 0,
  "volume": 30,
  "days": 30,
  "price": null,
  "qty": 1
}

اگر price خالی باشد از جدول plans + تخفیف حساب محاسبه می‌شود.

POST /v1/buy-test

{
  "server_index": 0,
  "wholesale": true,
  "force_paid": false
}

اولین تست رایگان (اگر هنوز استفاده نشده)
wholesale: true → هزینه از test_price_namayandegi از کیف پول صاحب توکن (مدل نمایندگی)
در غیر این صورت → test_price

POST /v1/renew

{
  "link_id": 123,
  "volume": 30,
  "days": 30,
  "is_reserve": false
}

POST /v1/cancel-reserve

{ "link_id": 123 }

پنل مدیریت لینک

Method	Path	توضیح
GET	/v1/links/{id}	جزئیات لینک
GET	/v1/links/{id}/volume	حجم مصرفی
GET	/v1/links/{id}/current	لینک فعلی پروتکل
GET	/v1/links/{id}/devices	دستگاه‌های متصل
GET	/v1/links/{id}/ip-link	لینک با IP مستقیم
POST	/v1/links/change-protocol	تغییر نوع لینک
POST	/v1/links/change-server	تغییر سرور
POST	/v1/links/change-domain	تغییر دامنه
POST	/v1/links/rotate-sub	چرخش سابسکریپشن
POST	/v1/links/change-ss-password	تعویض پسورد SS
POST	/v1/links/set-note	یادداشت
POST	/v1/links/set-alarm	آلارم حجم (۱–۹۹)
POST	/v1/links/stop	توقف لینک
POST	/v1/links/cancel	لغو + بازپرداخت تقریبی
GET	/v1/stopped/{id}	جزئیات لینک متوقف‌شده
POST	/v1/links/resume	فعال‌سازی مجدد لینک متوقف‌شده
POST	/v1/links/troubleshoot	ویزارد «لینکم کار نمی‌کنه» (step 0..4)

Resume

POST /v1/links/resume
{ "link_id": 123 }

عیب‌یابی (معادل ویزارد ربات)

POST /v1/links/troubleshoot
{ "link_id": 123, "step": 0 }

مراحل: ۰ شروع → ۱ پرواز → ۲ پروتکل Reality+XHTTP → ۳ لینک IP + ساب → ۴ پشتیبانی. در step=3 فیلدهای ip_link، domain_link و subscription_url برمی‌گردد.

تغییر پروتکل

POST /v1/links/change-protocol
{
  "link_id": 123,
  "protocol": "vless_reality_xhttp",
  "sni": "ea.com"
}

پروتکل‌های رایج: ss, vless_ws, vless_reality_xhttp, trojan_tcp, hysteria2, amneziawg, …

فراخوانی عمومی

POST /v1/action
{ "action": "buy_link", "params": { ... } }

مثال Python

import requests
BASE = "https://api.example.com"
H = {"Authorization": "Bearer ddv_xxx"}

servers = requests.get(f"{BASE}/v1/servers", headers=H).json()
buy = requests.post(f"{BASE}/v1/buy", headers=H, json={
    "server_index": 0, "volume": 30, "days": 30
}).json()
print(buy)