РестоБаза - документация по API РестоБазы для разработчиков

На этой странице описываются методы для получения информации о новостях ресторана:

news/getmany
news/getone

news/getmany

Описание метода

Метод необходим для получения списка новостей.

Параметры метода

Название параметра	Обязательный	Описание и возможные значения	Пример значения
`v`	да	Версия метода. Текущая версия метода - 2.	`2`
`page`	да	Номер страницы с новостями. Номер первой страницы - 1.	`1`
`limit`	да	Количество новостей на одну страницу. Максимальное значение - 20.	`10`

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

Получить 10 новостей ресторана:


<?php

include ('restobaza.class.php');  

$config = array(
  "co_id" => 1,
  "app_id" => 6,
  "app_secret" => 'tc1a7g8b12dbd445'
);

$restobaza = new Restobaza($config);

$api_params = array(
  "v" => 2,
  "page" => 1, 
  "limit" => 10
);

$rb_response = $restobaza->api('news/getmany', $api_params);
var_dump($rb_response);

?>

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

Если в ресторане нет новостей, то в ответе будет пустой массив. Если новости есть:

{
    "pagination": {
        "page": 1,
        "limit": 10,
        "total_pages": 2,
        "total_items": 15
    },
    "list": [
        {
            "id": "66",
            "name": "Name",
            "description": "Description ...",
            "cover": {
                "100": {
                    "width": 100,
                    "height": 67,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_100_5179421118499.jpg"
                },
                "150": {
                    "width": 150,
                    "height": 100,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_150_5179421118499.jpg"
                },
                "200": {
                    "width": 200,
                    "height": 133,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_200_5179421118499.jpg"
                },
                "300": {
                    "width": 300,
                    "height": 200,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_300_5179421118499.jpg"
                },
                "500": {
                    "width": 500,
                    "height": 333,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_500_5179421118499.jpg"
                },
                "1024": {
                    "width": 1024,
                    "height": 681,
                    "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_1024_5179421118499.jpg"
                }
            },
            "created_time": "2013-04-25T17:07:25+00:00",
            "images_count": "2"
        },
        {...}
    ]
}

Описание ответа

Список новостей содержится в ключе list, который представляет собой массив из объектов news.

Объект news:

Название поля Может быть пустым Описание Тип переменной

id

нет

Уникальный номер новости.

string

name

нет

Название новости.

string

description

нет

Описание новости.

string

images_count

нет

Количество фотографий в новости.

string

created_time

нет

UTC время публикации новости в формате ISO-8601 2012-04-15T11:37:29+00:00.

string

cover

да

Обложка новости.

Ключи в массиве - 100, 150, 200, 300, 500, 1024 - обозначают максимальную ширину изображения.

Минимальная гарантированная ширина изображения - 200 пикселей. Т.е. изображение в ключах 300, 500, 1024 могут иметь ширину меньше заявленной.

Изображения не имеют фиксированной высоты.

ассоциативный array

Название поля	Может быть пустым	Описание	Тип переменной
`source`	нет	Абсолютный URL адрес фотографии.	`string`
`width`	нет	Ширина фотографии в пикселях.	`string`
`height`	нет	Высота фотографии в пикселях.	`string`

Объект pagination содержит необходимую информацию для создания страниц с новостями:

Название поля	Может быть пустым	Описание	Тип переменной
`page`	нет	Значение, которое было передано в параметре `page` в запросе. Обозначает номер текущей страницы.	`string`
`limit`	нет	Значение, которое было передано в параметре `limit` в запросе. Обозначает максимальное количество новостей для одной страницы.	`string`
`total_pages`	нет	Общее количество страниц с новостями в ресторане.	`string`
`total_items`	нет	Общее количество новостей в ресторане.	`string`

news/getone

Описание метода

Метод необходим для создания отдельной страницы для новости, а также для создания отдельной страницы для фотографий новости.

Параметры запроса

Название параметра	Обязательный	Описание и возможные значения	Пример
`v`	да	Версия метода. Текущая версия метода - 2.	`2`
`id`	да	Уникальный номер новости.	`77`
`photos_page`	нет	Необходимая страница для фотографий новости. Данный параметр нужно указывать вместе с пареметром `photos_limit`. Чтобы получить первую страницу, указывайте значение 1.	`1`
`photos_limit`	нет	Максимальное количество фотографий новости на одну страницу. Данный параметр необходимо указывать вместе с пареметром `photos_page`. Если в запросе указаны оба параметра `photos_page` и `photos_limit`, то в ответе в ключе `images` появятся фотографии новости (если у новости есть фотографии). Максимальное количество фотографий на одну страницу - 50.	`10`
`other_limit`	нет	Количество других новостей. Если этот параметр указан, то в ответе в ключе `other` появится список из последних новостей ресторана. Указывайте этот параметр, если хотите создать ссылки на другие новости ресторана со страницы открытой новости. Максимальное количество других новостей - 10.	`6`

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

Получить новость с уникальным номером 77, 10 фотографий этой новости, а также 6 последних новостей ресторана:


<?php

include ('restobaza.class.php');  

$config = array(
  "co_id" => 1,
  "app_id" => 6,
  "app_secret" => 'tc1a7g8b12dbd445'
);

$restobaza = new Restobaza($config);

$api_params = array(
  "v" => 2,
  "id" => 77,
  "photos_page" => 1,
  "photos_limit" => 10,
  "other_limit" => 6
);
$rb_response = $restobaza->api('news/getone', $api_params);

?>

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

Если были указаны только обязательные параметры, в ответ вы получите объект news, при этом ключи images и other в объекте будут пустыми:

{
    "id": "66",
    "name": "Name",
    "description": "Description ...",
    "cover": {
        "100": {
            "width": 100,
            "height": 67,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_100_5179421118499.jpg"
        },
        "150": {
            "width": 150,
            "height": 100,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_150_5179421118499.jpg"
        },
        "200": {
            "width": 200,
            "height": 133,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_200_5179421118499.jpg"
        },
        "300": {
            "width": 300,
            "height": 200,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_300_5179421118499.jpg"
        },
        "500": {
            "width": 500,
            "height": 333,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_500_5179421118499.jpg"
        },
        "1024": {
            "width": 1024,
            "height": 681,
            "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_1024_5179421118499.jpg"
        }
    },
    "created_time": "2013-04-25T17:07:25+00:00",
    "images_count": "2",
    "images": [ ],
    "other": [ ]
}

Если в запросе были указаны дополнительные параметры photos_limit и photos_page, то ключ images будет содержать список фотографий новости. Если у новости нет фотографий, то этот ключ будет пустым.

"images": {
        "pagination": {
            "page": 1,
            "limit": 10,
            "total_pages": 1,
            "total_items": 2
        },
        "list": [
            {
                "id": "120",
                "caption": null,
                "sizes": {
                    "100": {
                        "width": 100,
                        "height": 67,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_100_517962e3932ac.jpg"
                    },
                    "150": {
                        "width": 150,
                        "height": 100,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_150_517962e3932ac.jpg"
                    },
                    "200": {
                        "width": 200,
                        "height": 133,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_200_517962e3932ac.jpg"
                    },
                    "1024": {
                        "width": 800,
                        "height": 533,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_1024_517962e3932ac.jpg"
                    }
                }
            },
            {...}
        ]
    },

В ответе, список фотографий содержится в ключе list, который представляет собой массив из объектов photo.

Объект photo:

Название поля Описание Может быть пустым Тип переменной

id

Уникальный номер фотографии.

нет

string

caption

Описание фотографии.

да

string

sizes

Ссылки на разные размеры фотографии.

Ключи в массиве - 100, 150, 200, 1024 - обозначают максимальную ширину изображения.

Минимальная гарантированная ширина изображения - 480 пикселей. Т.е. изображение в ключе 1024 может иметь ширину от 480 до 1024 пикселей.

Изображения не имеют фиксированной высоты.

нет

ассоциативный array

Название поля	Описание	Может быть пустым	Тип переменной
`source`	Абсолютный URL адрес фотографии.	нет	`string`
`width`	Ширина фотографии в пикселях.	нет	`string`
`height`	Высота фотографии в пикселях.	нет	`string`

Объект pagination содержит необходимую информацию для создания страниц с фотографиями:

Название поля	Может быть пустым	Описание	Тип переменной
`page`	нет	Значение, которое было передано в параметре `photos_page` в запросе. Обозначает номер текущей страницы.	`string`
`limit`	нет	Значение, которое было передано в параметре `photos_limit` в запросе. Обозначает максимальное количество фотографий для одной страницы.	`string`
`total_pages`	нет	Общее количество страниц с фотографиями в ресторане.	`string`
`total_items`	нет	Общее количество фотографий в новости.	`string`

Если был указан дополнительный параметр other_limit, то ключ other будет содержать список последних новостей ресторана. Если новостей в ресторане нет, то этот ключ будет пустым.

"other": {
        "pagination": {
            "page": 1,
            "limit": 10,
            "total_pages": 1,
            "total_items": 2
        },
        "list": [
            {
                "id": "66",
                "name": "Name",
                "description": "Description ...",
                "cover": {
                    "100": {
                        "width": 100,
                        "height": 67,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_100_5179421118499.jpg"
                    },
                    "150": {
                        "width": 150,
                        "height": 100,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_150_5179421118499.jpg"
                    },
                    "200": {
                        "width": 200,
                        "height": 133,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_200_5179421118499.jpg"
                    },
                    "300": {
                        "width": 300,
                        "height": 200,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_300_5179421118499.jpg"
                    },
                    "500": {
                        "width": 500,
                        "height": 333,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_500_5179421118499.jpg"
                    },
                    "1024": {
                        "width": 1024,
                        "height": 681,
                        "source": "http://img.restobaza_local.ru/co/co25/news/66/25_news_66_1024_5179421118499.jpg"
                    }
                },
                "created_time": "2013-04-25T17:07:25+00:00",
                "images_count": "2"
            },
            {...}
        ]
    }

Информация в ключе other ничем не отличается от той, которую можно получить с помощью метода news/getmany.

Разделы API » Новости

news/getmany

Описание метода

Параметры метода

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

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

Описание ответа

news/getone

Описание метода

Параметры запроса

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

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