Параметры проектов

Запрос позволяет получить названия и идентификаторы всех проектов, которые создал пользователь Кабинета разработчика.

Формат запроса

Чтобы посмотреть параметры всех проектов, используйте HTTP-запрос с методом GET:

GET /projects
Host: api-developer.tech.yandex.net
X-Auth-Key: <ваш API-ключ>
Заголовки запроса

Host

Адрес узла, предоставляющего API.

X-Auth-Key

Ключ авторизации.

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200. Тело ответа содержит объект в формате JSON:

{
    "projects": [
        {
            "id": "68981a83-056f-4a61-9d67-873e4e13fd2f",
            "name": "Project #1"
        },
        ...
    ]
}

Свойства ответа

Ключ

Значение

projects

Массив с информацией о проектах.

Свойства массива projects

id

Идентификатор проекта.

name

Название проекта.

Если запрос не был успешно обработан, ответное сообщение содержит информацию о возникших ошибках:

HTTP-код ошибки

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

400 Bad Request

Один из параметров запроса имеет недопустимое значение или формат данных.

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

404 Not Found

Запрашиваемый ресурс не найден.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

503 Service Unavailable

Сервис API временно недоступен.