Внимание! Запущено тестирование FoxTools API v2.0!
Если у вас возникнут каки-либо вопросы по работе с API, вы можете оставлять их на форуме группы FoxTools.ru.Proxy
Возвращает список прокси-серверов.Параметры
| Имя параметра | Тип | Обязательный | Описание |
|---|---|---|---|
| PAGE | Целое число | Нет | Номер страницы. Минимальное значение: 1. Значение по умолчанию: 1. |
| MAX | Целое число | Нет | Максимальное число прокси-серверов на странице. Минимальное значение: 1. Максимальное: 100. Значение по умолчанию: 50. |
| PROTOCOL | Целое число | Нет | Какие протоколы должны поддерживать прокси-сервера. Битовая маска. Список допустимых значений: 0 - любой протокол (тоже самое что и 1 + 2 + 4 + 8 = 15); 1 - HTTP; 2 - HTTPS; 4 - SOCKS 4 (не используется, зарезервировано); 8 - SOCKS 5 (не используется, зарезервировано). Значение по умолчанию: 0 (любые протоколы). |
| ANONYMITY | Логический | Нет | Задает необходимую степень анонимности прокси-серверов. Битовая маска. Список допустимых значений: 0 - любая степень анонимности (тоже самое что и 1 + 2 + 4 + 8 = 15); 1 - низкая; 2 - средняя; 4 - высокая; 8 - очень высокая. Значение по умолчанию: 0 (любая степень анонимности). |
| PORTFROM | Целое число | Нет | Минимальные номер порта. Например: 8888. Минимальное значение: 0. Максимальное значение: 65 535. Значение по умолчанию: 0 (любой номер порта). |
| PORTTO | Целое число | Нет | Максимальные номер порта. Например: 8888. Минимальное значение: 0. Максимальное значение: 65 535. Значение по умолчанию: 0 (любой номер порта). |
| COUNTRY | Целое число | Нет | Идентификатор страны в базе FoxTools.ru, в которой должны находиться прокси-сервера. Например: 181 - Россия. Значение по умолчанию: 0 (все страны). Список стран можно получить при помощи метода Countries. |
| UPTIME | Целое число | Нет | Максимальное время ответа прокси-сервера в секундах с момента последней проверки. Значение по умолчанию: 0 (любое время ответа). |
| AVAILABLE | Целое число | Нет | Статус доступности возвращаемых прокси-серверов. Возможные значения: 0 - любой статус доступности, 1 - только доступные прокси-сервера (по умолчанию), 2 - только недоступные прокси-сервера. |
| FREE | Целое число | Нет | Статус бесплатности возвращаемых прокси-серверов. Возможные значения: 0 - платные и бесплатные прокси-сервера, 1 - только бесплатные прокси-сервера (по умолчанию), 2 - только платные прокси-сервера (не используется, зарезервировано). |
Общие сведения
Все команды к API необходимо делать методом POST, на этот же адрес, на котором вы находитесь в данный момент (исключая корневой арес сайта). Тип содержимого (Content-Type) при запросах к API должен быть multipart/form-data.Для доступа к API обязательно нужно передовать идентификатор и открытый ключ доступа, которые можно получить в личном кабинете на сайте http://foxtools.ru в свойствах подключенного к сервису сайта.
Параметры для доступа к API
| Имя параметра | Тип | Обязательный | Описание |
|---|---|---|---|
| ID | Целое число | Да | Уникальный идентификатор сайта в системе. |
| KEY | Guid | Да | Открытый ключ доступа к API. |
| CID | Целое число | Нет | Пользовательский идентификатор. Данный параметр можно передавать, чтобы получать более детальную статистику использования сервера. Например, в этот параметр можно передавать идентификатор пользователя в вашей БД, чтобы знать, сколько раз пользователь использовал тот или иной сервис. |
| CGRP | Целое число | Нет | Группа для пользовательских идентификаторов (CID). Вы можете использовать этот параметр для группировки статистических данных. Например, если в CID вы передаете идентификатор пользователя в вашей БД, то параметр CGRP может быть равен 1. Если в CID вы передаете идентификатор страницы на вашем сайте, то CGRP может быть равен 2. Таким образом, вы сможете выделять статистику для пользователей (CGRP = 1) и страниц (CGRP = 2). |
Примечание. Регистр символов значения не имеет. Это касается любых параметров, как имен, так и значений.
Формат ответа
Выдача результата в API возможна в трех форматах: XML (по умолчанию), JSON, текстовой.Для указания формата выдачи необходимо добавить к адресу страницы запроса имя желаемого формата, через слеш.
Например:
http://api.foxtools.ru/v1/Proxy/xml
http://api.foxtools.ru/v1/Proxy/json
http://api.foxtools.ru/v1/Proxy/text
Дополнительная информация
| Состояние: | Работает |
|---|---|
| Использование: | Бесплатно |
| Всего запросов: | 32421020 |
| Запросов сегодня: | 673 |
| Первый запрос: | 12.11.2012 18:09:12 |
| Последний запрос: | 24.08.2017 9:31:17 |