Информация |
---|
Требует лицензию на модули address и ip. |
Включить страницу |
---|
| SGTDOC:О «Подсказках»: город по IP-адресу |
---|
| SGTDOC:О «Подсказках»: город по IP-адресу |
---|
|
Запрос
POST:
Без форматирования |
---|
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{ "ip": "2a0d:e100::12", "language": "ru" }' \
http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/iplocate/address |
Метод POST поддерживается в подсказках начиная с версии 21.1
GET:
Без форматирования |
---|
curl -X GET \
-H "Accept: application/json" \
http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/iplocate/address?ip=2a0d:e100::12 |
Раскрыть |
---|
title | Для версии 19.1 и ранее |
---|
|
Без форматирования |
---|
curl -X GET \
-H "Accept: application/json" \
http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/detectAddressByIp?ip=2a0d:e100::12 |
|
Включить страницу |
---|
| _Заголовки (API) |
---|
| _Заголовки (API) |
---|
|
Параметры
Параметр | Обязательный? | Описание |
---|
ip | нет | IP-адрес. Если не указан, используется IP-адрес из HTTP-запроса |
language | нет | Язык отображения адреса в результатах поиска (en/ru) 20.3+ |
Ответ (19.1+)
Объект вида:
Блок кода |
---|
{
"location": {
"value": "г Москва",
"unrestricted_value": "г Москва",
"data": { ... }
}
} |
Где location — это объект адреса .
Если местоположение определить не удалось, то location = null:
Без форматирования |
---|
{
"location": null
} |
Раскрыть |
---|
title | Ответ для версий 18.12 и раньше |
---|
|
Объект вида: Блок кода |
---|
{
"location": {
"value": "83.220.54.223",
"unrestricted_value": null,
"data": { ... }
}
} |
Где location.value — это IP-адрес клиента, а location.data заполнен аналогично полю data в объекте адреса. |
Алгоритм выбора IP-адреса из параметров запроса
Без форматирования |
---|
ЕСЛИ IP указан в параметре ip
ТО использовать его
ИНАЧЕ
ЕСЛИ IP указан в HTTP-заголовке X-Forwarded-For
ТО использовать его
ИНАЧЕ вернуть IP сокета соединения |
Местоположение определяется только для российских адресов.