Проекты

Проект — это граница изоляции, внутри которой существует всё остальное: потребители, устройства, API-ключи, биллинг и история аудита привязаны ровно к одному проекту. Ничто не пересекает эту границу — учётные данные одного проекта не могут читать другой.

Создание и список проектов

Семейство /platform/v1/projects покрывает весь жизненный цикл:

После создания UUID проекта — это то, что вы отправляете в X-Project-Id при каждом вызове /platform/v1, и то, к чему привязаны ваши API-ключи.

Участники и роли

У проекта есть участники-люди, у каждого — роль, определяющая, что ему доступно:

• owner — полный контроль, включая удаление и передачу владения
• admin — повседневное управление
• member — обычный участник
• viewer — только чтение

Биллинговые полномочия — это вторая, независимая ось (owner / billing_admin / billing_viewer), чтобы доступ к финансам не был обязан следовать за инженерным доступом. Управляйте обеими осями под /platform/v1/projects/{project_id}/members — GET для списка участников, PATCH …/members/{user_id}/role для смены роли, PATCH …/members/{user_id}/billing-scope для настройки биллинговой оси и DELETE …/members/{user_id}, чтобы удалить участника.

Новые люди присоединяются по приглашению: создайте его через POST /platform/v1/projects/{project_id}/invites; приглашённый принимает ссылку с токеном и попадает в проект с той ролью, которая указана в приглашении.

Журнал аудита

Каждое административное действие в проекте — выпуск и отзыв ключей, смена ролей, биллинговые операции — записывается и доступно для запроса по GET /platform/v1/projects/{project_id}/audit-log. Записи несут актора, субъект и снимки «до/после» там, где они применимы, поэтому вы можете ответить на вопрос «кто это изменил и когда», не заводя тикет.

Справочник

Полные формы запросов и ответов для каждой операции выше — в сгенерированном справочнике API в разделах projects, members и invites.