FoxTools v.2.0

хитрые инструменты

Application Programming Interface (API)

Проект FoxTools предоставляет бесплатный доступ ко всем службам сайта по средствам API (Application Programming Interface). Более того, практически все сервисы самого FoxTools.ru работают через API.

Для работы с API необходимо иметь навыки программирования, в том числе: отправка и получение HTTP-запросов, понимание базовых принципов работы протокола HTTP и Интернета, работа с текстовыми, бинарными данными, обработка XML и/или JSON данных.

Для доступа к API необходима регистрация на сайте FoxTools.ru.

API расположен по адресу: http://api.foxtools.ru/.

Интерфейс принимает POST-запросы и позволяет выдавать ответы в форматах: XML, JSON или TEXT. Для GET-запросов интерфейс выдает справочную информацию по использованию методов API.

Запросы к API можно выполнять как с сайтов, так и из приложений.

Если вы программируете под .NET Framework, то вы можете скачать готовую библиотеку для работы с API.

Скачать FoxTools.Lib.zip (версия: 1.2013.7.21)

Скачать пример использования на Visual Basic .NET

Скачать пример использования на C#

Другие файлы и примеры вы можете найти по следующей ссылке: http://files.foxtools.ru/Api/

 

Как получить доступ к API?

Чтобы получить доступ к API, необходимо зарегистрироваться на сайте FoxTools.ru.

Если вы уже имеете учетную запись на сайте FoxTools.ru, то перейдите в личный кабинет: http://foxtools.ru/cabinet и нажмите на кнопку «Подключить приложение».

Рис. 1. Расположение кнопки «Подключить приложение» в Личном кабинете
Рис. 1. Расположение кнопки «Подключить приложение» в Личном кабинете.

Выберите тип приложения, укажите адрес сайта, название и описание для каталога (каталог, возможно, появится позже), после чего нажмите на кнопку «Далее».

Обратите внимание, любые параметры приложения вы в любое время сможете без проблем изменить.

Рис. 2. Ввод основной информации о приложении
Рис. 2. Ввод основной информации о приложении.

На следующем шаге вы можете указать IP-адреса, с которых будет осуществляться доступ к API. Это поможет исключить неправомерное использование API с вашим ключем доступа. Вы можете пропустить этот шаг. Для продолжения нажмите кнопку «Далее».

Рис. 3. Настройка ограничений доступа к API по IP
Рис. 3. Настройка ограничений доступа к API по IP.

На следующем шаге выберите бесплатные инструменты (службы, сервисы), которые будут доступны по API. Вы можете выбрать одну или несколько, или все службы, ограничений никаких нет. Имена служб соответствуют именам страниц API-методов на сайте http://api.foxtools.ru. На рисунке № 4 выбрано три службы: IDN, IP и QR, это означает, что сайт сможет работать только с этими тремя инструментами, а при отправке запросов к не подключенным службам, API будет возвращать ошибку доступа. Для продолжения нажмите кнопку «Далее».

Рис. 4. Выбор служб, которые будут доступны подключаемому сайту
Рис. 4. Выбор служб, которые будут доступны подключаемому сайту.

Аналогичным образом выберите платные инструменты, если они есть, и нажмите кнопку «Сохранить», чтобы сохранить параметры приложения. После этого, в списке приложений появится подключенное приложение.

Для доступа к API необходимо указывать идентификатор приложения и открытый ключ. Узнать идентификатор приложения и ключ доступа можно прямо в списке приложений, смотрите рисунок № 5. На рисунке у приложения «Ёлпер» идентификатор 4, а ключ 5767dcf5-****-****-****-90aba4d4135a (вместо звездочек буквы и цифры).

Рис. 5. Расположение идентификаторов и ключей доступа в списке приложений в Личном кабинете
Рис. 5. Расположение идентификаторов и ключей доступа в списке приложений в Личном кабинете.

Помимо этого, данные для доступа конкретного приложения к API можно получить в параметрах приложения. Для этого необходимо нажать на кнопку «Редактировать» в списке приложений. Параметры доступа к API находятся на вкладке с соответствующим заголовком.

Рис. 6. Просмотр параметров доступа к API в параметрах приложения
Рис. 6. Просмотр параметров доступа к API в параметрах приложения.

При желании, вы можете сгенерировать новый ключ доступа к API. Также вы можете указать секретный ключ. На сегодняшний день секретный ключ в API не используется.

Идентификатор и ключ доступа нужно использовать при всех запросах к API. Например, чтобы получить информацию об IP-адресе 171.204.20.75 через метод http://api.foxtools.ru/IP, необходимо сформировать POST-запрос вида:

POST http://api.foxtools.ru/IP?id=4&key=5767dcf5-****-****-****-90aba4d4135a&ip=171.204.20.75 HTTP/1.1
Host: api.foxtools.ru
Content-Length: 0
  

Обратите внимание, в запросе указанном выше передается ключ в параметре key и идентификатор приложения в параметре id. В дополнительном параметре ip передается IP-адрес, информацию о котором нужно получить. При успешном выполнении запроса, сервер вернет ответ вида:

HTTP/1.1 200 OK
Cache-Control: private
Content-Type: text/xml; charset=utf-8
Server: Microsoft-IIS/7.5
Date: Sat, 29 Dec 2012 12:14:52 GMT
Content-Length: 590

<?xml version="1.0" encoding="utf-8"?>
<foxtools version="2.2012.11.16">
  <ip version="2.2012.11.16">
    <value>171.204.20.75</value>
    <country>
      <id>221</id>
      <iso3166-1-a2>US</iso3166-1-a2>
      <nameRu>США</nameRu>
      <nameEn>USA</nameEn>
      <iso3166-1-a3>USA</iso3166-1-a3>
      <iso3166-1-num>840</iso3166-1-num>
      <fips10>US</fips10>
      <stanag>USA</stanag>
      <domain>.us</domain>
      <phoneCode>1</phoneCode>
      <updated />
    </country>
    <city>
      <name>Concord</name>
      <nameEn>Concord</nameEn>
      <zip>94520</zip>
      <metroCode>807</metroCode>
      <areaCode>925</areaCode>
      <longitude>-122.0318</longitude>
      <latitude>38.0033</latitude>
    </city>
  </ip>
</foxtools>

 

Если у вас возникнут каки-либо вопросы по работе с API, вы можете оставлять их на форуме группы FoxTools.ru.

диагностика авто киев .

Сайт построен на HTML5

Для корректной работы данного сайта требуется HTML5.

Пожалуйста, воспользуйтесь браузером, который поддерживает HTML5. Многие современные браузеры поддерживают HTML5. Например:

За дополнительной информацией обращайтесь к администратору сайта: support [собака] foxtools.ru

HTML5

×

Вы действительно хотите выйти из системы?

 

Да, выйти   Нет

×