# 檢視組織連接資源 Canonical URL: https://sosoapi.ai/zh-hant/docs/api/identity-api-organization-connections-review Contract: sha256:563d2d581da0ad29 按 operation_id 讀取待確認連接所發現嘅平台帳戶及專頁供審核。此操作唯讀；由使用者喺網頁確認連接。 POST /identity-api/organization/connections/review ## 驗證及權限 - **接受嘅憑證類型:** user_session, delegated_oauth, personal_access_token - **委派權限:** agent:operate - **最低工作空間角色:** 此 contract 冇指定工作空間最低角色；仍需符合擁有權及授權檢查。 - **存取範圍:** 已登入使用者及獲授權資源範圍 - **需要所有工作空間同意:** 唔係 - **會改動狀態:** 唔係 - **完成依據:** synchronous_http_response 憑證唔能夠擴大持有人權限。實際操作仍會檢查工作空間成員資格、資源擁有權、已選工作空間及能力授權。Tool profile 只改變可見工具，唔會授權。 ## 請求欄位 ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "organization_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "operation_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "organization_id", "operation_id" ], "additionalProperties": false } ``` ## 回應及完成條件 成功 HTTP 狀態碼: 200 HTTP 成功只表示呢次操作嘅回應。背景工作要保留回傳 ID，讀取同一操作直到文件指定嘅終態。接受請求、排程成功或客戶端逾時，都唔代表已發佈。 ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "operation_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "organization_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "provider": { "type": "string", "enum": [ "meta", "instagram", "threads", "google_youtube", "x" ] }, "status": { "type": "string", "enum": [ "review_required", "confirming", "partially_confirmed", "confirmed", "failed", "expired" ] }, "resources": { "maxItems": 500, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "resource_type": { "type": "string", "minLength": 1 }, "provider_resource_id": { "type": "string", "minLength": 1 }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_username": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider_tasks": { "type": "array", "items": { "type": "string" } }, "provider_permissions": { "type": "array", "items": { "type": "string" } }, "capability_facts": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "discovery_status": { "type": "string", "enum": [ "discovered", "action_required", "unavailable", "unknown" ] }, "selection_state": { "type": "string", "enum": [ "unselected", "selected", "attached", "superseded" ] } }, "required": [ "id", "resource_type", "provider_resource_id", "display_name", "display_username", "provider_tasks", "provider_permissions", "capability_facts", "discovery_status", "selection_state" ] } } }, "required": [ "operation_id", "organization_id", "provider", "status", "resources" ] } ``` ## 錯誤及安全重試 檢查 HTTP 狀態及實際回應格式。驗證400可能回傳 ZodError；handler 錯誤可能係 error／message／code envelope。保留可用嘅 request_id 或 x-request-id，唔好記錄憑證。401／403先修正存取問題；429遵守 Retry-After。寫入結果未明或5xx時，先讀原有結果，再決定重試；只喺操作支援時重用 idempotency key，並冇通用重試或 exactly-once 保證。 ## 範例 以下虛構值已按 contract 驗證，唔係真實帳戶 ID、憑證或發佈紀錄。請用已授權範圍回傳嘅 ID、已準備好嘅素材及已審核排程取代，寫入前核對平台資格。此頁唔會呼叫 API。 喺伺服器環境設定 SOSOAPI_ACCESS_TOKEN，使用此操作接受嘅憑證。唔好放入瀏覽器程式。一般 agent 建議透過 sosoapi auth login 用瀏覽器 OAuth，由 CLI 管理憑證更新。 request.json ```json { "organization_id": "11111111-1111-4111-8111-111111111111", "operation_id": "11111111-1111-4111-8111-111111111111" } ``` cURL ```bash curl --request POST \ "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/organization/connections/review" \ -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @request.json ``` JavaScript ```js // Server-side JavaScript. Do not print tokens or credential-bearing responses. const token = process.env.SOSOAPI_ACCESS_TOKEN; if (!token) throw new Error("Set an accepted credential for this operation"); const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/organization/connections/review", { method: "POST", headers: { "Content-Type": "application/json", Authorization: "Bearer " + token }, body: JSON.stringify({ "organization_id": "11111111-1111-4111-8111-111111111111", "operation_id": "11111111-1111-4111-8111-111111111111" }) }); const result = await response.json(); // Check response.ok, the operation-specific body and completion state before continuing. ``` CLI ```bash npx sosoapi api post /identity-api/organization/connections/review < request.json ``` 虛構回應範例 ```json { "operation_id": "11111111-1111-4111-8111-111111111111", "organization_id": "11111111-1111-4111-8111-111111111111", "provider": "meta", "status": "review_required", "resources": [] } ``` ## 相關工具及指南 MCP: sosoapi_review_organization_connection [API reference](https://sosoapi.ai/zh-hant/docs/api)