لاگ‌ها
رکوردهای درخواست سرویس Mobile 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. نمی‌تواند پیش از آغاز باشد.
گروه وضعیت HTTP. فقط Mobile و Residential؛ رکوردهای خانواده ISP کد وضعیت HTTP ندارند و آنجا 400 برمی‌گرداند (به‌جای آن از result، category یا ok استفاده کنید).
حد پایین مدت باز ماندن اتصال، بر حسب میلی‌ثانیه (عدد صحیح نامنفی). تأخیر نیست؛ برای تأخیر از min_latency_ms استفاده کنید.
حد بالای مدت باز ماندن، بر حسب میلی‌ثانیه. نمی‌تواند کمتر از min_duration_ms باشد.
تعداد رکورد در هر صفحه: 1 تا 200، پیش‌فرض 50. مقدار 0، منفی یا غیرصحیح 400 برمی‌گرداند؛ مقدار بیش از 200 به 200 کاهش می‌یابد (meta.limit مقدار اعمال‌شده را نشان می‌دهد).
تعداد رکوردهایی که از ابتدا رد می‌شوند. offset + limit نمی‌تواند از 10000 بیشتر شود؛ به‌جای رفتن به عمق بیشتر، بازه را با start/end محدودتر کنید.