Метод для получения города по IP-адресу
Метод позволяет получить город по IP-адресу в России.
Адрес: https://data.pbprog.ru/api/address/ip
Тип: POST
Content-Type: application/json
Авторизация: требуется
Соединение с БД: требуется
Описание заголовков
| Ключ заголовков | Тип | Обязательность | Описание |
|---|---|---|---|
| Authorization | string | о | Для передачи токена авторизации |
Описание тела запроса
| Наименование параметра | Тип | Обязательность | Описание |
|---|---|---|---|
| ip | string | о | IP-адрес. |
Ответы
| Код ответа | Описание |
|---|---|
| 200 | Запрос успешно обработан |
| 400 | Некорректный запрос |
| 401 | В запросе отсутствует токен, или токен неверного формата, или в запросе указан несуществующий токен |
| 5хх | Произошла внутренняя ошибка сервиса |
Описание ответа
В качестве ответа возвращается массив элементов, структура которых представлена ниже.
| Переменная | Тип | Описание |
|---|---|---|
| value | string | Адрес одной строкой |
| unrestricted_value | string | Адрес одной строкой (полный, с индексом) |
| data | array | Массив с детальной информацией по элементам адреса |
Структура элементов массива - data
Примечание
Переменные, которые не заполняются, в ответе всегда будут равны null.
| Переменная | Тип | Описание |
|---|---|---|
| postal_code | string | Почтовый индекс |
| country | string | Страна |
| country_iso_code | string | ISO-код страны |
| federal_district | string | Федеральный округ (Не заполняется) |
| region_fias_id | string | Код ФИАС региона |
| region_kladr_id | string | Код КЛАДР региона |
| region_with_type | string | Регион с типом |
| region_type | string | Тип региона (сокращенный) |
| region_type_full | string | Тип региона |
| region | string | Регион |
| region_add_to_reestr_date | string | Дата внесения записи о регионе в реестр |
| area_fias_id | string | Код ФИАС района в регионе |
| area_kladr_id | string | Код КЛАДР района в регионе |
| area_with_type | string | Район в регионе с типом |
| area_type | string | Тип района в регионе (сокращенный) |
| area_type_full | string | Тип района в регионе |
| area | string | Район в регионе |
| area_add_to_reestr_date | string | Дата внесения записи о районе в реестр |
| city_fias_id | string | Код ФИАС города |
| city_kladr_id | string | Код КЛАДР города |
| city_with_type | string | Город с типом |
| city_type | string | Тип города (сокращенный) |
| city_type_full | string | Тип города |
| city | string | Город |
| city_add_to_reestr_date | string | Дата внесения записи о городе в реестр |
| city_area | string | Административный округ (только для Москвы) (Не заполняется) |
| city_district_fias_id | string | Код ФИАС района города (заполняется, только если район есть в ФИАС) |
| city_district_kladr_id | string | Код КЛАДР района города (не заполняется) |
| city_district_with_type | string | Район города с типом |
| city_district_type | string | Тип района города (сокращенный) |
| city_district_type_full | string | Тип района города |
| city_district | string | Район города |
| city_district_add_to_reestr_date | string | Дата внесения записи о городском районе в реестр |
| settlement_fias_id | string | Код ФИАС населенного пункта |
| settlement_kladr_id | string | Код КЛАДР населенного пункта |
| settlement_with_type | string | Населенный пункт с типом |
| settlement_type | string | Тип населенного пункта (сокращенный) |
| settlement_type_full | string | Тип населенного пункта |
| settlement | string | Населенный пункт |
| settlement_add_to_reestr_date | string | Дата внесения записи о населенным пункте в реестр |
| street_fias_id | string | Код ФИАС улицы |
| street_kladr_id | string | Код КЛАДР улицы |
| street_with_type | string | Улица с типом |
| street_type | string | Тип улицы (сокращенный) |
| street_type_full | string | Тип улицы |
| street | string | Улица |
| street_add_to_reestr_date | string | Дата внесения записи о улице в реестр |
| stead_fias_id | string | Код ФИАС земельного участка |
| stead_kladr_id | string | Код КЛАДР земельного участка |
| stead_cadnum | string | Кадастровый номер земельного участка |
| stead_type | string | Тип земельного участка (сокращенный) |
| stead_type_full | string | Тип земельного участка |
| stead | string | Номер земельного участка |
| stead_add_to_reestr_date | string | Дата внесения записи о земельном участке в реестр |
| house_fias_id | string | Код ФИАС дома |
| house_kladr_id | string | Код КЛАДР дома |
| house_type | string | Тип дома (сокращенный) |
| house_type_full | string | Тип дома |
| house | string | Дом |
| house_add_to_reestr_date | string | Дата внесения записи о доме в реестр |
| house_cadnum | string | Кадастровый номер дома |
| block_type | string | Тип корпуса/строения (сокращенный) |
| block_type_full | string | Тип корпуса/строения |
| block | string | Корпус/строение |
| entrance | string | Подъезд (Не заполняется) |
| floor | string | Этаж (Не заполняется) |
| flat_fias_id | string | Код ФИАС квартиры (Не заполняется) |
| flat_type | string | Тип квартиры (сокращенный) |
| flat_type_full | string | Тип квартиры |
| flat | string | Квартира |
| flat_add_to_reestr_date | string | Дата внесения записи о квартире в реестр |
| flat_cadnum | string | Кадастровый номер квартиры |
| flat_area | string | Площадь квартиры (Не заполняется) |
| square_meter_price | string | Рыночная стоимость м² (Не заполняется) |
| flat_price | string | Рыночная стоимость квартиры (Не заполняется) |
| postal_box | string | Абонентский ящик (Не заполняется) |
| fias_id | string | ФИАС-код адреса |
| fias_code | string | Не заполняется, рекомендуется использовать fias_id |
| fias_level | string | Уровень детализации, до которого адрес найден в ФИАС |
| fias_actuality_state | string | Признак актуальности адреса в ФИАС |
| kladr_id | string | Код КЛАДР |
| okato | string | Код ОКАТО |
| oktmo | string | Код ОКТМО |
| tax_office | string | Код ИФНС для физических лиц (Не заполняется) |
| tax_office_legal | string | Код ИФНС для организаций (Не заполняется) |
| timezone | string | Часовой пояс города для России (Не заполняется) |
| geo_lat | string | Широта (Не заполняется) |
| geo_lon | string | Долгота (Не заполняется) |
| beltway_hit | string | Внутри кольцевой?(Не заполняется) |
| beltway_distance | string | Расстояние от кольцевой в км (Не заполняется) |
| metro | string | Список ближайших станций метро (до трёх штук) |
| qc_geo | string | Код точности координат |
| qc_complete | string | Код пригодности к рассылке(Не заполняется) |
| qc_house | string | Признак наличия дома в ФИАС (Не заполняется) |
| history_values | string | Список исторических названий объекта нижнего уровня |
| unparsed_parts | string | Не заполняется |
| source | string | Не заполняется |
| qc | string | Код проверки адреса (Не заполняется) |
| object_id | string | ID объекта (служебный для баз ФИАС) |
| Код | Описание |
|---|---|
| 0 | Страна |
| 1 | Регион |
| 3 | Район |
| 4 | Город |
| 5 | Район города |
| 6 | Населенный пункт |
| 7 | Улица |
| 8 | Дом |
| 65 | Планировочная структура |
| -1 | Иностранный или пустой |
| Код | Описание |
|---|---|
| 0 | Актуальный |
| null | Не определен |
Примеры
Пример запроса:
Заголовок запроса:
Authorization: Token 123abcde123abcde123adcde123abcde123abcde
Тело запроса:
{
"ip": "86.102.2.150"
}
{
"location": {
"value": "Приморский край, г Владивосток",
"unrestricted_value": "Приморский край, г Владивосток",
"data": {
"postal_code": null,
"country": "Россия",
"country_iso_code": "RU",
"federal_district": null,
"region_fias_id": "43909681-d6e1-432d-b61f-ddac393cb5da",
"region_kladr_id": "2500000000000",
"region_iso_code": null,
"region_with_type": "Приморский край",
"region_type": "край",
"region_type_full": "край",
"region": "Приморский",
"region_add_to_reestr_date": "15.09.2015",
"area_fias_id": null,
"area_kladr_id": null,
"area_with_type": null,
"area_type": null,
"area_type_full": null,
"area": null,
"area_add_to_reestr_date": null,
"city_fias_id": "7b6de6a5-86d0-4735-b11a-499081111af8",
"city_kladr_id": "2500000100000",
"city_with_type": "г Владивосток",
"city_type": "г",
"city_type_full": "город",
"city": "Владивосток",
"city_add_to_reestr_date": "22.09.2018",
"city_area": null,
"city_district_fias_id": null,
"city_district_kladr_id": null,
"city_district_with_type": null,
"city_district_type": null,
"city_district_type_full": null,
"city_district": null,
"city_district_add_to_reestr_date": null,
"settlement_fias_id": null,
"settlement_kladr_id": null,
"settlement_with_type": null,
"settlement_type": null,
"settlement_type_full": null,
"settlement": null,
"settlement_add_to_reestr_date": null,
"street_fias_id": null,
"street_kladr_id": null,
"street_with_type": null,
"street_type": null,
"street_type_full": null,
"street": null,
"street_add_to_reestr_date": null,
"stead_fias_id": null,
"stead_kladr_id": null,
"stead_cadnum": null,
"stead_type": null,
"stead_type_full": null,
"stead": null,
"stead_add_to_reestr_date": null,
"house_fias_id": null,
"house_kladr_id": null,
"house_type": null,
"house_type_full": null,
"house": null,
"house_add_to_reestr_date": null,
"house_cadnum": null,
"block_type": null,
"block_type_full": null,
"block": null,
"entrance": null,
"floor": null,
"flat_fias_id": null,
"flat_type": null,
"flat_type_full": null,
"flat": null,
"flat_add_to_reestr_date": null,
"flat_cadnum": null,
"flat_area": null,
"square_meter_price": null,
"flat_price": null,
"postal_box": null,
"fias_id": "7b6de6a5-86d0-4735-b11a-499081111af8",
"fias_code": null,
"fias_level": "4",
"fias_actuality_state": "0",
"kladr_id": "2500000100000",
"geoname_id": null,
"capital_marker": null,
"okato": "05401000000",
"oktmo": "05701000001",
"tax_office": null,
"tax_office_legal": null,
"timezone": null,
"geo_lat": null,
"geo_lon": null,
"beltway_hit": null,
"beltway_distance": null,
"metro": null,
"qc_geo": "5",
"qc_complete": null,
"qc_house": null,
"history_values": null,
"unparsed_parts": null,
"source": null,
"qc": null,
"object_id": 383163
}
}
}