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 |
|
Параметр | Обязательный? | Описание |
---|---|---|
ip | нет | IP-адрес. Если не указан, используется IP-адрес из HTTP-запроса |
language | нет | Язык отображения адреса в результатах поиска (en/ru) 20.3+ |
Ответ (19.1+)
Объект вида:
{ "location": { "value": "г Москва", "unrestricted_value": "г Москва", "data": { ... } } } |
Где location — это объект адреса .
Если местоположение определить не удалось, то location = null:
{ "location": null } |
Объект вида:
Где location.value — это IP-адрес клиента, а location.data заполнен аналогично полю data в объекте адреса. |
ЕСЛИ IP указан в параметре ip ТО использовать его ИНАЧЕ ЕСЛИ IP указан в HTTP-заголовке X-Forwarded-For ТО использовать его ИНАЧЕ вернуть IP сокета соединения |
Местоположение определяется только для российских адресов.