PUBLIC API DOCUMENTATION

مستندات عمومی API

ثبت، ویرایش، بررسی و مدیریت پراکسی‌ها با REST API و پاسخ استاندارد JSON.

BASE URLhttps://monitor.example.com/api/

احراز هویت

تمام عملیات API به کلید معتبر نیاز دارند. کلید را فقط از پنل مدیریت بسازید و در هدر Authorization ارسال کنید.

Authorization: Bearer pp_YOUR_API_TOKEN
Content-Type: application/json

توکن و Secret را داخل URL قرار ندهید؛ آن‌ها را فقط در Header و بدنه JSON ارسال کنید.

POST?action=create

ثبت پراکسی

پراکسی را با فیلدهای اتصال یا مستقیماً با لینک MTProto ثبت می‌کند. hostname به IP عمومی تبدیل و IP درخواست‌کننده نیز ثبت می‌شود.

فیلد	الزامی	توضیح
`name`	✓	نام نمایشی، ۱ تا ۱۲۰ کاراکتر
`proxy_url`	MTProto*	`t.me/proxy` · `tg://proxy` · `host:port:secret`
`type`	*	`mtproto \| socks5 \| http`
`host`	*	IPv4, IPv6, hostname
`port`	*	1–65535
`secret`	MTProto*	classic, `dd`, Fake-TLS `ee`
`check_interval`	—	1, 15, 30, 45, 60

نمونه ثبت هوشمند

curl -X POST "https://monitor.example.com/api/?action=create" \
  -H "Authorization: Bearer pp_YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"Germany MTProto",
    "proxy_url":"https://t.me/proxy?server=proxy.example.com&port=443&secret=ee...",
    "check_interval":15
  }'

POST?action=parse-proxy

تحلیل لینک MTProto

لینک را اعتبارسنجی و hostname را به IP تبدیل می‌کند. Secret در پاسخ نمایش داده نمی‌شود.

REQUEST

{"proxy_url":"https://t.me/proxy?server=proxy.example.com&port=443&secret=ee..."}

RESPONSE

{
  "ok": true,
  "data": {
    "type": "mtproto",
    "source_host": "proxy.example.com",
    "host": "203.0.113.20",
    "port": 443
  }
}

GET?action=list

فهرست پراکسی‌ها

وضعیت، آپ‌تایم، تأخیر و زمان بررسی بعدی را برمی‌گرداند. Secret در خروجی وجود ندارد.

POST?action=update

ویرایش پراکسی

نام، نوع، IP/Host، پورت، Secret و بازه بررسی را ویرایش می‌کند. Secret خالی مقدار فعلی MTProto را حفظ می‌کند.

{"id":25,"name":"Edge Updated","type":"mtproto","host":"1.2.3.4","port":443,"secret":"","check_interval":15}

POST?action=check

بررسی فوری

یک بررسی فوری اجرا و نتیجه را در تاریخچه ثبت می‌کند.

{"id":25}

POST?action=delete

حذف پراکسی

پراکسی و تاریخچهٔ وابسته به آن را حذف می‌کند.

{"id":25}

کدهای خطا

401 unauthorized403 forbidden404 not_found409 email_exists419 csrf_failed422 validation_failed422 invalid_proxy_link422 host_resolution_failed500 server_error