API Proxy Checker'а

Разработчикам программ для проверки доступности proxy-серверов мы предоставляем API нашего Proxy Checker'а. Интерфейс допускает параллельную обработку многих запросов, при этом на данный момент пул рабочих процессов является общим. Каких-то лимитов на число параллельных запросов от одного пользователя пока нет. Поэтому при параллельном опросе следует ориентироваться главным образом на адекватность нагрузки: опрос в 10 потоков - вполне нормальное поведение, а разовая проверка базы в 3 тысячи серверов - не лучшая идея. В случае перегрузки происходит отказ в обслуживании новых запросов - HTTP ответ с кодом 5xx.

Для проверки нужно сделать HTTP запрос (GET или POST) на URI http://www.zahodi-ka.ru/proxy/check/ со следующими параметрами:

p - описание proxy-сервера в формате протокол://хост:порт; протокол: http / socks5; хост - IP-адрес, либо доменное имя;
timeout - максимальное время проверки в секундах (до 60, по умолчанию - 10)

В случае удачной проверки система возвращает XML-документ следующего содержания:

<ok> <ip>123.123.123.123</ip>  <remote-ip>123.123.123.123</remote-ip> 
 <http-forwarded-for>1</http-forwarded-for> <http-via>1</http-via>  <domain>proxy-server.com</domain>  <protocol>http</protocol>  <port>8080</port>  <time>5</time>  </ok>

В случае ошибки:

<er> <code>001</code>  <text>Неизвестный формат определения proxy-сервера</text> 
 <ip>123.123.123.123</ip> <domain>proxy-server.com</domain> <protocol>http</protocol> <port>8080</port> <time>5</time> </er>

Текстовое сообщение об ошибке может со временем меняться, поэтому закладываться на него не рекомендуется, это больше служебная информация для разработчика. Разделять ошибки следует по коду:

001 - неправильно указан proxy-сервер для проверки: неизвестный формат / протокол / некорректный домен
002 - невозможно определить IP-адрес машины по доменному имени
16384 - любая неинтерпретированная ошибка