api.oboi.ru v2.004¶

https://api.oboi.ru

Разрабатывалась для oboi.ru по заказу отдела маркетинга. Первоначальный ТЗ - устный, несформулированный. Примерно так: Надо чтобы карточки товаров содержали все при все, чтобы любые категории, вендоры и коллекции были. Чтобы картинок было много разных. Чтобы описания у коллекций и вендоров.

Warning

deprecated - переходи на v3

Общая информация¶

Клиенты¶

Аутентификация¶

аутентификация добавлением в Header apiKey: UUID
ключи делятся на два типа: client -r и admin -rw

Управление контентом¶

контент обновляется с помощью web GUI - Media Fabrica
цены назначаются с помощью Media Fabrica.
при проведении в 1C розница документа установка цен номенклатуры с видом цен Прайс-лист Интернет-магазин происходит обновление цен через api метод ?????????

Статусы ответов¶

Status	Description
`200`	все прекрасно
`401`	ошибка аутентификации. apiKey отсутствует или не разрешен
`500`	непредусмотренная ошибка на сервере

Умная фильтрация¶

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

request

отбор данных с помощью фильтра

{
    "filter": {
        "category": "Обои",
        "name": ["Грация", "Эвелина"]
    }
}

API методы - клиент¶

Товар¶

категории товаров¶

GET /category

response

{
    "response": [
        {
            "_id": "5c763ff3ec5cd391e59d5ad4",
            "description": "Обои преображают Вас",
            "imgBackground": "",
            "imgLogo": "",
            "name": "Обои",
            "vendor": [
                "Victoria Stenova",
                "Startdeco",
                "Wallberry",
                "Freedom",
                "Bravo",
                "Seela",
                "Parrot",
                "Rose"
            ]
        },

вендоры¶

POST /vendor

response request

{
    "response": [
        {
            "_id": "5c88fb36ec5cd391e59d8128",
            "category": "Обои",
            "collection": [
                "Amarona",
                "Bartolomeo",
                "Gabriella",
                "Stella",
                "WAVE",
                "Paris",
                "SAMANTA",
                "ARIEL",
                "POLINA",
                "MAGDALENA",
                "BOND",
                "NATALI",
                "VENEZIA"
            ],
            "description": "StartDeco – это экслюзивная линейка обоев,
                            произведенная компанией РЕГИОНПРОЕКТ и
                            ведущей российской интерьерной дизайн –
                            студией Victoria Stenova.Особенностью этих
                            обоев является высочайшее качество материалов,
                            трендовые дизайны, популярные цвета – и все
                            это по самой привлекательной цене в данном
                            сегменте обоев.",
            "imgLogo": {},
            "name": "Startdeco",
            "youtube": ""
        },

{
    "filter": {
        "category": ["Обои", "Клей"]}
}

коллекции¶

POST /collection

response request

{
    "response": [
        {
            "_id": "5d2dfc03bd14183801aada38",
            "category": "Обои",
            "description": "",
            "imgBackground": {},
            "name": "Грация",
            "product": [
                "81215BR42",
                "81214BR44",
                "81215BR44",
                "81214BR43",
                "81215BR43",
                "81214BR42"
            ],
            "vendor": "Bravo",
            "youtube": ""
        },

{
    "filter": {
        "category": "Обои",
        "name": ["Грация", "Эвелина"]
    }
}

товары¶

POST /product

response request

{
    "response": [

{}