لاگ‌ها
رکوردهای اتصال سرویس Datacenter Proxy را با امکان فیلتر و صفحهبندی برمی‌گرداند.
https://api.proxynet.io/api/v1/orders/{id}/logsپلن شما باید دسترسی به لاگ را شامل شود. در ISP، Datacenter و Gaming هر رکورد یک اتصال است و هنگام بسته شدن اتصال نوشته می‌شود؛ معنای فیلدها در صفحه رکوردهای لاگ آمده است. جدیدترین رکورد اول می‌آید.
هر رکورد با همان مجموعه ثابت کلیدها برمی‌گردد؛ فیلدی که مقدار ندارد حذف نمی‌شود، بلکه null برمی‌گردد.
مقادیر نامعتبر فیلتر بی‌صدا نادیده گرفته نمی‌شوند و 400 invalid_request برمی‌گردانند. یک پارامتر ناشناخته، بازه‌ای که آغازش پس از پایانش باشد، یا ارسال پارامتری مخصوص ISP برای سرویس Mobile/Residential نیز 400 برمی‌گرداند؛ details.field می‌گوید کدام پارامتر است. offset + limit نمی‌تواند از 10000 بیشتر شود.
اگر meta.partial برابر true باشد، ممکن است فهرست ناقص باشد: در خانواده ISP رکوردهای قدیمی در آن لحظه قابل خواندن نبوده‌اند و در Mobile/Residential فقط جدیدترین رکوردها برگشته‌اند. کمی بعد دوباره تلاش کنید. اگر meta.source برابر none باشد، هنوز منبع لاگی برای این سرویس وجود ندارد. اگر مخزن لاگ موقتاً در دسترس نباشد، 503 service_unavailable برمی‌گردد.
مجوزدهی
به‌صورت Bearer <token> ارسال می‌شود. این نقطه پایانی مجوز logs:read (لاگ‌ها) را لازم دارد؛ توکنی که این مجوز را نداشته باشد پاسخ 403 می‌گیرد.
پارامترهای مسیر
شناسه سرویس. آن را از فیلد id در پاسخ GET /orders بگیرید.
پارامترهای کوئری
سطح؛ می‌تواند چند بار ارسال شود. در خانواده ISP از کد نتیجه به دست می‌آید: 0 ← connect، 100/101 ← auth، 105/106 ← quota، 201 ← disconnect، کدهای دیگر ← error. رکوردهای پیش از 17 سپتامبر 2026 فقط می‌توانند connect یا error باشند.
جستجوی آزاد IP. فقط رقم، a-f، . و : پذیرفته می‌شوند. در خانواده ISP یک آدرس کامل IPv4/IPv6 دقیقاً با IP کلاینت، هدف، خروجی یا ورودی تطبیق داده می‌شود؛ بخشی از آدرس (مثلاً 185.23) باید دست‌کم 3 کاراکتر باشد و در آدرس هدف جستجو می‌شود (فقط رکوردهای پس از 17 سپتامبر 2026). در Mobile/Residential در آدرس هدف یا کلاینت جستجو می‌شود. برای جستجو با نام دامنه از target_host استفاده کنید.
آغاز، ISO-8601. در خانواده ISP روی لحظه بسته شدن اتصال اعمال می‌شود و به لحظه ایجاد سفارش محدود می‌شود؛ رکورد قدیمی‌تر برنمی‌گردد.
پایان، ISO-8601. نمی‌تواند پیش از آغاز باشد.
حد پایین مدت باز ماندن اتصال، بر حسب میلی‌ثانیه (عدد صحیح نامنفی). تأخیر نیست؛ برای تأخیر از min_latency_ms استفاده کنید.
حد بالای مدت باز ماندن، بر حسب میلی‌ثانیه. نمی‌تواند کمتر از min_duration_ms باشد.
تعداد رکورد در هر صفحه: 1 تا 200، پیش‌فرض 50. مقدار 0، منفی یا غیرصحیح 400 برمی‌گرداند؛ مقدار بیش از 200 به 200 کاهش می‌یابد (meta.limit مقدار اعمال‌شده را نشان می‌دهد).
تعداد رکوردهایی که از ابتدا رد می‌شوند. offset + limit نمی‌تواند از 10000 بیشتر شود؛ به‌جای رفتن به عمق بیشتر، بازه را با start/end محدودتر کنید.
خانواده ISP. true فقط اتصال‌های موفق، false فقط اتصال‌های ناموفق.
خانواده ISP. کد نتیجه، مثلاً 105. می‌تواند تکرار شود یا با ویرگول جدا شود. کدها در صفحه رکوردهای لاگ آمده‌اند.
خانواده ISP. دسته نتیجه. می‌تواند تکرار شود یا با ویرگول جدا شود.
خانواده ISP. یک اتصال را با مقدار requestId آن (یک ULID با 26 کاراکتر) پیدا می‌کند.
خانواده ISP. IP کلاینت شما (sourceIp)؛ آدرس کامل IPv4/IPv6، تطبیق دقیق.
خانواده ISP. IP خروجی (egressIp)؛ آدرس کامل IPv4/IPv6، تطبیق دقیق.
خانواده ISP. نام میزبان هدف یا بخشی از آن (حرف، رقم، . و -)؛ به بزرگی و کوچکی حروف حساس نیست. دست‌کم 3 کاراکتر؛ فقط در رکوردهای پس از 17 سپتامبر 2026 جستجو می‌شود.
خانواده ISP. پروتکلی که واقعاً استفاده شده است: http یا socks5.
خانواده ISP. true فقط رکوردهای UDP ASSOCIATE؛ false فیلتری اعمال نمی‌کند.
خانواده ISP. شماره اسلات پورت (1 تا 100000).
خانواده ISP. پورت پروکسی‌ای که به آن وصل می‌شوید (gatePort، 1 تا 65535).
خانواده ISP. اتصال‌هایی که تأخیر برقراری اتصالشان دست‌کم این تعداد میلی‌ثانیه است (1 تا 3600000). رکوردهایی که تأخیرشان اندازه‌گیری نشده (latencyMs null) کنار گذاشته می‌شوند.