Метод getAddress

Описание

С помощью данного метода можно получить адреса и координаты известных точек приёма сертификатов определённого бренда или всех доступных брендов. Допускается фильтрация по бренду, региону и населённому пункту.

Параметры запроса (data)

Параметр	Описание
product_id	Идентификатор продукта (см. метод getProducts, поле id)
area_name	Название региона, например Омская область (поиск регистронезависимый)
locality_name	Название населённого пункта, например Омск (поиск регистронезависимый)

Для параметров product_id и locality_name можно осуществлять поиск по нескольким значениям, значения в таком случае передаются в виде списка.

Все параметры не являются обязательными. Можно получить все известные точки приёма всех доступных брендов, если передать пустой запрос.

Параметры ответа (data)

См. результат запроса.

Пример

# Получаем значение для подстановки SIG
# SECRET в данном случае - это хранящийся у клиента ключ для подписи запросов к API
$ echo -n 'getAddress{"product_id":2111}SECRET' | sha256sum - | awk '{print $1}'

# Используем известный клиенту ID и сгенерированный SIG для выполнения запроса
$ curl 'https://ssl-api.giftery.ru/?cmd=getAddress&id=ID&in=json&out=json&data=%7B%22product_id%22%3A2111%7D&sig=SIG'

# Для поиска нескольких продуктов сразу
$ echo -n 'getAddress{"product_id":[2111,726]}SECRET' | sha256sum - | awk '{print $1}'
$ curl 'https://ssl-api.giftery.ru/?cmd=getAddress&id=ID&in=json&out=json&data=%7B%22product_id%22%3A%5B2111%2C726%5D%7D&sig=SIG'

Аналогичным образом можно производить поиск по locality_name.

Результат запроса

{
  "status": "ok",
  "data": {
    "Омская область": {
      "Омск": {
        "2111" : [
          ["Россия, Омск, Волгоградская улица, 2", "54.982497 73.27671"],
          ["Россия, Омск, Волгоградская улица, 4", "54.983497 73.27771"]
        ]
      }
    }
  }
}