Руководство разработчика
Ресурсы API

Информация о магазине

Краткое содержание

Описание

/shop/{shop_id}

Возвращает информацию об указанном магазине.

В запросе вместо {shop_id} указывается идентификатор магазина.

URL ресурса:

https://api.content.market.yandex.ru/v1/shop/{shop_id}.[format]

Выходные данные

Структура выходных данных:

Внимание! В выходных данных выводятся служебные параметры, которые не описаны в таблице.
Примечание. Если информация об указанном магазине не полная, то в ответе могут быть заполнены не все параметры.
<shop
[no-highlight[

Значение

Описание магазина.

]no-highlight]
id
[no-highlight[

Значение

Идентификатор магазина.

Для формата XML является атрибутом параметра shop.

]no-highlight]
="{идентификатор_магазина}"> <created-at
[no-highlight[

Значение

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

]no-highlight]
>{дата_регистрации_магазина}</created-at> <fact-address
[no-highlight[

Значение

Фактический адрес магазина.

]no-highlight]
>{фактический_адрес}</fact-address> <grade-total
[no-highlight[

Значение

Количество оценок магазина.

]no-highlight]
>{количество_оценок}</grade-total> <juridical-address
[no-highlight[

Значение

Юридический адрес магазина.

]no-highlight]
>{юридический_адрес}</juridical-address> <name
[no-highlight[

Значение

Юридическое название магазина.

]no-highlight]
>{юридическое_название_магазина}</name> <ogrn
[no-highlight[

Значение

Регистрационный номер юридического лица.

]no-highlight]
>{регистрационный_номер}</ogrn> <rating
[no-highlight[

Значение

Рейтинг магазина.

]no-highlight]
>{значение_рейтинга}</rating> <shop-name
[no-highlight[

Значение

Название магазина.

]no-highlight]
>{название_магазина}</shop-name> <status
[no-highlight[

Значение

Статус магазина на Маркете.

]no-highlight]
>{статус_магазина_на_Маркете}</status> <type
[no-highlight[

Значение

Тип организации.

Возможные значения:

  • CHP — частный предприниматель (ЧП);

  • IP — индивидуальный предприниматель (ИП);

  • NONE — тип организации не указан;

  • OOO — общество с ограниченной ответственностью (ООО);

  • OTHER — другой тип организации;

  • PBOUL — предприятие без образования юридического лица (ПБОЮЛ);

  • ZAO — закрытое акционерное общество (ЗАО).

]no-highlight]
>{тип_организации}</type> <url
[no-highlight[

Значение

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.
]no-highlight]
>{URL}</url> </shop>
{
  "shop
[no-highlight[

Значение

Описание магазина.

]no-highlight]
": { "id
[no-highlight[

Значение

Идентификатор магазина.

Для формата XML является атрибутом параметра shop.

]no-highlight]
": {идентификатор_магазина}, "createdAt
[no-highlight[

Значение

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

]no-highlight]
": "{дата_регистрации_магазина}", "factAddress
[no-highlight[

Значение

Фактический адрес магазина.

]no-highlight]
": "{фактический_адрес}", "gradeTotal
[no-highlight[

Значение

Количество оценок магазина.

]no-highlight]
": {количество_оценок}, "juridicalAddress
[no-highlight[

Значение

Юридический адрес магазина.

]no-highlight]
": "{юридический_адрес}", "name
[no-highlight[

Значение

Юридическое название магазина.

]no-highlight]
": "{юридическое_название_магазина}", "ogrn
[no-highlight[

Значение

Регистрационный номер юридического лица.

]no-highlight]
": "{регистрационный_номер}", "rating
[no-highlight[

Значение

Рейтинг магазина.

]no-highlight]
": {значение_рейтинга}, "shopName
[no-highlight[

Значение

Название магазина.

]no-highlight]
": "{название_магазина}", "status
[no-highlight[

Значение

Статус магазина на Маркете.

]no-highlight]
": "{статус_магазина_на_Маркете}", "type
[no-highlight[

Значение

Тип организации.

Возможные значения:

  • CHP — частный предприниматель (ЧП);

  • IP — индивидуальный предприниматель (ИП);

  • NONE — тип организации не указан;

  • OOO — общество с ограниченной ответственностью (ООО);

  • OTHER — другой тип организации;

  • PBOUL — предприятие без образования юридического лица (ПБОЮЛ);

  • ZAO — закрытое акционерное общество (ЗАО).

]no-highlight]
": "{тип_организации}", "url
[no-highlight[

Значение

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.
]no-highlight]
": "{URL}" } }

Описание параметров:

Параметр для формата XMLПараметр для формата JSONТипЗначение
shop shop

Описание магазина.

Параметры, вложенные в shop
id id Long

Идентификатор магазина.

Для формата XML является атрибутом параметра shop.

created-at createdAt Date

Дата регистрации магазина на Маркете.

Формат: ГГГГ-ММ-ДД.

fact-address factAddress String

Фактический адрес магазина.

grade-total gradeTotal Число

Количество оценок магазина.

juridical-address juridicalAddress String

Юридический адрес магазина.

name name String

Юридическое название магазина.

ogrn ogrn String

Регистрационный номер юридического лица.

rating rating Число

Рейтинг магазина.

shop-name shopName String

Название магазина.

status status String

Статус магазина на Маркете.

type type Enum

Тип организации.

Возможные значения:

  • CHP — частный предприниматель (ЧП);

  • IP — индивидуальный предприниматель (ИП);

  • NONE — тип организации не указан;

  • OOO — общество с ограниченной ответственностью (ООО);

  • OTHER — другой тип организации;

  • PBOUL — предприятие без образования юридического лица (ПБОЮЛ);

  • ZAO — закрытое акционерное общество (ЗАО).

url url String

URL, содержащий контактную информацию магазина.

Примечание. Параметр может быть пустым, если магазин не добавил контактную информацию.

Описания ошибок

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

Примеры

Пример запроса:

GET https://api.content.market.yandex.ru/v1/shop/1581.xml

Пример ответа:

<shop id="1581">
  <created-at>2001-04-24</created-at>
  <fact-address>Сигнальный презд, д. 5</fact-address>
  <juridical-address>Сигнальный презд, д. 5</juridical-address>
  <grade-total>0</grade-total>
  <name>Магазин</name>
  <ogrn>1037715013779</ogrn>
  <rating>4</rating>
  <shop-name>Мой магазин</shop-name>
  <status>actual</status>
  <type>OOO</type>
  <url>www.shop_name.ru</url>
</shop>

Пример запроса:

GET https://api.content.market.yandex.ru/v1/shop/1581.json

Пример ответа:

{
  "shop":
  {
    "id": 1581,
    "createdAt":"2001-04-23",
    "factAddress": "Сигнальный презд, д. 5",
    "gradeTotal": 0,
    "juridicalAddress": "Сигнальный презд, д. 5",
    "name": " Магазин",
    "ogrn": "1037715013779",
    "rating": 4,
    "shopName": "Мой магазин",
    "status": "actual",
    "type": "OOO",
    "url": "www.shop_name.ru"
  }
}
shop/{shop_id} Магазины