Справочник API
Приглашения
Создание приглашений участников и принятие по ссылке.
Кому подходит
- Owner / admin — добавление сотрудников.
- Новым участникам — активация аккаунта.
POST /api/organizations/{orgId}/invitations
Создать приглашение. Требуется Bearer-токен owner или admin.
Тело:
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
email | string | да | Email приглашаемого |
role | string | да | admin, developer, viewer |
curl -s -X POST https://api.example.com/api/organizations/org_abc/invitations \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"email":"dev@example.com","role":"developer"}'Ответ 201:
{
"id": "inv_xyz",
"organizationId": "org_abc",
"email": "dev@example.com",
"role": "developer",
"status": "pending"
}Ошибки: 403 — роль не может приглашать; 400 — invalid role, пустой email.
Аудит: member.invited.
Список приглашений доступен в GET /api/overview → invitations.
POST /api/invitations/{id}/accept
Принять приглашение. Авторизация не требуется.
Тело: { "password": "…" } (минимум 8 символов по правилам регистрации)
curl -s -X POST https://api.example.com/api/invitations/inv_xyz/accept \
-H "Content-Type: application/json" \
-d '{"password":"secure-password"}'Ответ 200: { "token", "email" }
После accept:
- создаётся credential;
- участник добавляется в
membersс ролью из приглашения; - статус приглашения →
accepted.
Аудит: member.joined.
Статусы приглашения
| status | Значение |
|---|---|
pending | Ожидает принятия |
accepted | Принято |