Proxy POST GET

Предоставляет доступ к списку прокси-серверов.


Запросы следует отправлять на адрес:

Поддерживаются запросы методом GET и POST.

По умолчанию ответ сервера будет в формате JSON. Для получения ответа в другом формате, можно добавить расширение к файлу в адресе: .xml, .html или .txt. Например: /v2/Proxy.xml Либо использовать HTTP-заголовок Accept: text/xml, text/html или text/plain.


Параметры

Имя параметра Тип Обязательный По умолчанию Описание
type ProxyProtocol Нет All Какие протоколы необходимы. Допустимы битовые значения.
anonymity ProxyAnonymity Нет All Уровень анонимности. Допустимы битовые значения.
available YesNoAny Нет Yes Индикатор, указывающий статус доступности прокси.
free YesNoAny Нет Yes Индикатор, указывающей необходимость вернуть только бесплатные прокси.
port String Нет NULL Список портов. Допустимо указние диапазона через запятую. Например: 1000, 2000.
country String Нет NULL Стандартный ISO код (рекомендуется) или название страны, для которой следует получить список серверов.
uptime Int32 Нет NULL Максимально допустимое время ответа сервера (в секунудах).
page Int32 Нет 1 Номер страницы, для которой следует получить данные.
limit Int32 Нет 100 Максимальное число данных.
Общие параметры

В таблице ниже представлен список параметров, которые могут быть использованы при запросе к любому методу API.

Имя параметра Тип Обязательный По умолчанию Описание
appId Int32 Нет NULL Идентификатор приложения.
appSecret String Условно NULL Секретный ключ приложения.
token String Нет NULL Маркер доступа клиента, полученный методом GetToken.
formatting ResponseFormatting Нет None Определяет параметры форматирования выдачи результатов.
details Boolean Нет False Позволяет отобразить дополнительную информацию о запросе.
cp String Нет UTF-8 Имя кодовой страницы.
lang Language Нет Auto Язык, на котором будут выдаваться системные сообщения. Этот параметр также можно использовать при работе со справочной информацией API.
auth Boolean Нет False При наличии этого параметра, сервер вернет ответ с кодом HTTP401 и потребует указание идентификатора приложения и секретного ключа в HTTP заголовке Authorization.

Результат

Возвращает результат типа ProxyResult.

Имя свойства Тип Описание
Исходное XML JSON
PageNumber pageNumber pageNumber Int32 Номер текущей страницы.
PageCount pageCount pageCount Int32 Общее количество страниц.
Items items items ProxyResultItem[] Список прокси-серверов для текущей страницы.
Messages messages messages Message[] Список сообщений системы.
Trace trace trace TraceItem[] Детальная информация о выполнении запроса. Добавляется, если параметр details имеет значение True.

Имя XML и JSON используется при выдаче результатов в XML и, соответственно, JSON.

Если имя XML начинается с символа «собака» (@), то значит в XML это имя будет использоваться в качестве имени атрибута, а не самостоятельного элемента.

Исходное имя - это имя, которое используется непосредственно в коде API.


Ошибки

При возникновении ошибок, будет возвращаен результат типа ErrorResult.

В некоторых случаях, в ответе сервера могут содержать предупреждения (Warning) и сообщения о проблемах (Critical), которые можно найти в коллекции Messages. При этом, ответ сервера будет иметь тип ProxyResult.

Если метод содержит сообщения типа Critical, то можно считать, что работа метода завершена с ошибкой. Подобное поведение свойствено методам, в которых производится обработка списка данных, где каждый элемент списка является независимым от других элментов. Т.е. в таких случаях запрос может быть выполнен частично.


Статистика


Конструктор запросов

type:
anonymity:
available:
free:
port:
country:
uptime:
page:
limit:

http:
lang:
auth:
cp: