（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）

複數組織管理功能是一個強大的工具，可讓您為不同的組織執行操作。對於管理多個組織並需要經常在不同組織之間切換的使用者來說，該功能尤其有用。

它是如何運行的？

該功能的關鍵是組織 ID，這是每個組織的唯一標識碼。該 ID 可從 Console 或聯繫我們的服務團隊取得。

當您取得組織的 ID，就可以使用它代表該組織執行操作。這可以通過在 API 請求中設置 x-bv-org-id 標頭來實現。x-bv-org-id 標頭會告訴我們的系統您代表哪個組織執行操作。

x-bv-org-id 標頭用於指定您要管理的組織。將 your-organization-id 替換為貴組織的實際 ID，可確保請求與貴組織正確地關聯。

以下是一個 cURL 的範例：

curl --request GET \
  --url https://api.one.blendvision.com/bv/<some-api> \
  --header 'Accept: application/json' \
  --header 'authorization: Bearer <your-api-token>' \
  --header 'x-bv-org-id: <your-organization-id>'

取得貴組織的 ID

要取得當前組織的 ID，可以使用以下 API：
GET /bv/org/v1/organizations

以下是一個使用 cURL 實現此功能的範例：

curl --request GET \
  --url https://api.one.blendvision.com/bv/org/v1/organizations \
  --header 'Accept: application/json' \
  --header 'authorization: Bearer <your-api-token>'

成功的回應如以下範例：

{
  "organization": {
    "id": "string",
    "name": "string",
    "parent_id": "string",
    "type": "ORGANIZATION_TYPE_BUSINESS",
    "status": "ORGANIZATION_STATUS_ACTIVATED",
    "description": "string",
    "owner_email": "string",
    "billing_cycle": 0,
    "contract_valid_start_time": "2019-08-24T14:15:22Z",
    "contract_months": 0,
    "contract_days": 0,
    "contract_valid_end_time": "2019-08-24T14:15:22Z",
    "has_sub_orgs": true,
    "parent_name": "string",
    "license_key": "string",
    "time_zone": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

organization  物件中的 id 欄位即為貴組織的 ID。

哪些 API支援此功能？

僅部分 API 支持複數組織管理功能。請參閱具體的 API 文件，瞭解其是否支援該功能。