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

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

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

Чтобы посмотреть параметры всех проектов, используйте 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 временно недоступен.

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

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