組織 API
組織管理端點 — 建立、邀請、成員管理。
組織（Organizations）
組織是 NexRex 中教練管理的頂層單位。每個教練帳號屬於一個組織。
POST /organizations
建立組織。
GET /organizations/{org_id}
取得組織詳情。
PUT /organizations/{org_id}
更新組織資料。
邀請（Invitations）
POST /organizations/{org_id}/invitations
建立邀請連結。
Request Body
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| `type` | string | ✅ | 邀請類型（`athlete`, `coach`） |
| `email` | string | ❌ | 指定 email 邀請 |
| `expires_in_days` | number | ❌ | 過期天數（預設 7） |
Response (201)
{"invitation_id": "abc123", "invite_url": "https://nexrex.ai/invite/abc123"}
GET /organizations/{org_id}/invitations
取得邀請列表。
DELETE /organizations/{org_id}/invitations/{invitation_id}
刪除邀請。
GET /invitations/validate
驗證邀請連結是否有效。
Query Parameters
| 參數 | 類型 | 說明 |
|---|---|---|
| `code` | string | 邀請碼 |
POST /invitations/accept
接受邀請。
Request Body
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| `code` | string | ✅ | 邀請碼 |
成員（Members）
GET /members
取得成員列表。
GET /members/{member_id}
取得成員詳情。
PUT /members/{member_id}/labels
更新成員標籤。
配額（Quota）
GET /organizations/{org_id}/quota
取得組織的選手配額使用狀況。
Response (200)
{"used": 45, "total": 100, "plan": "coach"}
審計紀錄（Audit Logs）
GET /organizations/{org_id}/audit-logs
取得組織的操作紀錄。