Документация по API сервиса

Основные данные

Все запросы отправляются на адрес

http://ip.intrumnet.com/api/public/

Запросы можно отправлять и с помощью javascript. Сервер будет отправлять нужный заголовок

Access-Control-Allow-Origin: *

Каждый тип запроса имеет свой action который указывается в пути запроса, например для action=get путь запроса будет выглядеть так

http://ip.intrumnet.com/api/public/get/

Формат ответа

Ответ отправляется в кодировке UTF-8
На данный момент есть 2 возможных формата ответа json(по умолчанию) , xml, и нужный должен быть указан в запросе в виде параметра response_type. (GET или POST)

http://ip.intrumnet.com/api/public/get/?response_type=xml
Если ответ нужен в формате JSON то параметр можно опустить

В случае XML все параметры ответа будут содержаться в виде тэгов в корневом элементе <response>

Зпрос

Запрос должен отправляться в кодировке UTF-8
Тип запроса может зависить от конкретного action и будет указан в описании самого action. Но в основном все запросы можно посылать как GET так и POST, так же возможно использовать одновременно!

---

Action «get»

Запрос

Параметр	Обязательный	По Умолчанию	Описание	Тип	Пример
ip	Нет	Нет	(Если не указан то будет использован ip с которого отправлен запрос)	ipv4	192.168.0.1
locale	Нет	ru	Код локализации (ru,en,ja,es,de,fr)	string	ru

Пример реализации запроса на PHP

$request = array(
    'ip' => '82.142.128.66'
);
$context = array(
    'http' => {
        'method' => 'POST' ,
        'content' => http_build_query($request)
    }
);
$response = json_decode(file_get_contents('http://ip.intrumnet.com/api/public/get/' , NULL , $context));

Ответ

Параметр	Описание	Тип	Пример
country	Сокращенное название страны	String	RU
area	Окгру (Устарело)	String	Центральный федеральный округ
region	Регион	String	Москва
city	Город	String	Москва
lat	Широта (Центр города)	decimal	55.755787
lng	Долгота (Центр города)	decimal	37.617634
ip	ip адрес по которому выдалась информация	ipv4	82.142.128.66
provider	Название провайдера	string	..telecom

---

Action «exchangerates»

Запрос

Параметр	Обязательный	Описание	Тип	Пример
currencys	Нет	Список необходимых валют	Array	[‘USD’,’EUR’]

Пример реализации запроса на PHP

$request = array(
    'currencys' => {
        'method' => 'POST' ,
        'content' => http_build_query($request)
    }
);
$response = json_decode(file_get_contents('http://ip.intrumnet.com/api/public/exchangerates/' , NULL , $context));

Ответ

Параметр	Описание	Тип	Пример
date	Дата за которую отданы курсы	Date(dd.mm.yyyy)	17.03.2016
exchangerates	Список валют	Object	{‘USD’:’70.66’,’EUR’:’78.68’}