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

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

albums/getmany
albums/getone

albums/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('albums/getmany', $api_params);

?>

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

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

{
    "pagination": {
        "page": 1,
        "limit": 2,
        "total_pages": 1,
        "total_items": 2
    },
    "list": [
        {
            "id": "20",
            "name": "name",
            "description": "text",
            "images_count": "2",
            "cover": {
                "100": {
                    "width": 100,
                    "height": 67,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_100_517a67993a4e3.jpg"
                },
                "150": {
                    "width": 150,
                    "height": 100,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_150_517a67993a4e3.jpg"
                },
                "200": {
                    "width": 200,
                    "height": 133,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_200_517a67993a4e3.jpg"
                },
                "300": {
                    "width": 300,
                    "height": 200,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_300_517a67993a4e3.jpg"
                },
                "500": {
                    "width": 500,
                    "height": 333,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_500_517a67993a4e3.jpg"
                },
                "1024": {
                    "width": 1024,
                    "height": 682,
                    "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_1024_517a67993a4e3.jpg"
                }
            },
            "updated_time": "2013-04-26T11:40:25+00:00",
            "created_time": "2013-04-26T11:40:03+00:00"
        },
        {...}
    ]
}

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

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

Объект album:

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

id

нет

Уникальный номер альбома.

string

name

нет

Название альбома.

string

description

нет

Описание альбома.

string

images_count

нет

Количество фотографий в альбоме.

string

updated_time

нет

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

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`

albums/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('albums/getone', $api_params);

?>

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

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

{
    "id": "20",
    "name": "name",
    "description": "text",
    "images_count": "2",
    "cover": {
        "100": {
            "width": 100,
            "height": 67,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_100_517a67993a4e3.jpg"
        },
        "150": {
            "width": 150,
            "height": 100,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_150_517a67993a4e3.jpg"
        },
        "200": {
            "width": 200,
            "height": 133,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_200_517a67993a4e3.jpg"
        },
        "300": {
            "width": 300,
            "height": 200,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_300_517a67993a4e3.jpg"
        },
        "500": {
            "width": 500,
            "height": 333,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_500_517a67993a4e3.jpg"
        },
        "1024": {
            "width": 1024,
            "height": 682,
            "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_1024_517a67993a4e3.jpg"
        }
    },
    "updated_time": "2013-04-26T11:40:25+00:00",
    "created_time": "2013-04-26T11:40:03+00:00",
    "images": [ ],
    "other": [ ]
}

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

"images": {
        "pagination": {
            "page": 1,
            "limit": 2,
            "total_pages": 1,
            "total_items": "2"
        },
        "list": [
            {
                "id": "194",
                "caption": null,
                "sizes": {
                    "100": {
                        "width": 100,
                        "height": 67,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_100_517a67a91cd79.jpg"
                    },
                    "150": {
                        "width": 150,
                        "height": 100,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_150_517a67a91cd79.jpg"
                    },
                    "200": {
                        "width": 200,
                        "height": 133,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_200_517a67a91cd79.jpg"
                    },
                    "1024": {
                        "width": 800,
                        "height": 533,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_1024_517a67a91cd79.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": 2,
            "total_pages": 1,
            "total_items": 2
        },
        "list": [
            {
                "id": "20",
                "name": "name",
                "description": "text",
                "images_count": "2",
                "cover": {
                    "100": {
                        "width": 100,
                        "height": 67,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_100_517a67993a4e3.jpg"
                    },
                    "150": {
                        "width": 150,
                        "height": 100,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_150_517a67993a4e3.jpg"
                    },
                    "200": {
                        "width": 200,
                        "height": 133,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_200_517a67993a4e3.jpg"
                    },
                    "300": {
                        "width": 300,
                        "height": 200,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_300_517a67993a4e3.jpg"
                    },
                    "500": {
                        "width": 500,
                        "height": 333,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_500_517a67993a4e3.jpg"
                    },
                    "1024": {
                        "width": 1024,
                        "height": 682,
                        "source": "http://img.restobaza_local.ru/co/co25/albums/20/25_albums_20_1024_517a67993a4e3.jpg"
                    }
                },
                "updated_time": "2013-04-26T11:40:25+00:00",
                "created_time": "2013-04-26T11:40:03+00:00"
            },
            {...}
        ]
    }

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

Разделы API » Альбомы

albums/getmany

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

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

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

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

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

albums/getone

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

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

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

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