Разделы API » Вакансии

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

• vacancies/getmany
• vacancies/getone

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

?>

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

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

{
    "pagination": {
        "page": 1,
        "limit": 2,
        "total_pages": 1,
        "total_items": 2
    },
    "list": [
        {
            "id": "16",
            "name": "name",
            "emp_type": "Удалённая работа",
            "emp_schedule": "Свободный график",
            "manager": "elena",
            "phone": "234-12-56",
            "email": "asdf@asdf.er",
            "description": "text",
            "updated_time": "2013-04-26T12:09:16+00:00"
        },
        {...}
    ]
}

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

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

Объект vacancy:

Название поля	Может быть пустым	Описание	Тип переменной
id	нет	Уникальный номер вакансии.	string
name	нет	Название вакансии.	string
emp_type	нет	Тип занятости. Может принимать следующие значения: постоянная работа, временная работа, стажировка, удаленная работа.	string
emp_schedule	нет	График работы. Может принимать следующие значения: полный рабочий день, неполный рабочий день, сменный график, свободный график.	string
description	нет	Описание вакансии.	string
updated_time	нет	UTC время публикации / обновления вакансии в формате ISO-8601: 2012-04-12T05:18:55+00:00.	string
manager	да	Контактное лицо по вакансии.	string
phone	да	Телефон для связи.	string
email	да	E-Mail для резюме.	string
Название поля Может быть пустым Описание Тип переменной source нет Абсолютный URL адрес фотографии. string width нет Ширина фотографии в пикселях. string height нет Высота фотографии в пикселях. string

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

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

vacancies/getone

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

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

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

Название параметра	Обязательный	Описание и возможные значения	Пример
v	да	Версия метода. Текущая версия метода - 2.	2
id	да	Уникальный номер вакансии.	77
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,
  "other_limit" => 6
);
$rb_response = $restobaza->api('vacancies/getone', $api_params);

?>

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

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

{
  "id": "16",
  "name": "name",
  "emp_type": "Удалённая работа",
  "emp_schedule": "Свободный график",
  "manager": "elena",
  "phone": "234-12-56",
  "email": "asdf@asdf.er",
  "description": "text",
  "updated_time": "2013-04-26T12:09:16+00:00",
  "other": [ ]
}

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

"other": {
        "pagination": {
            "page": 1,
            "limit": 2,
            "total_pages": 1,
            "total_items": 2
        },
        "list": [
            {
                "id": "16",
                "name": "name",
                "emp_type": "Удалённая работа",
                "emp_schedule": "Свободный график",
                "manager": "elena",
                "phone": "234-12-56",
                "email": "asdf@asdf.er",
                "description": "text",
                "updated_time": "2013-04-26T12:09:16+00:00"
            },
            {...}
        ]
    }

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