查詢數位人組織

更新時間：2026-07-13 11:57:31

介面描述

1、查询数字人关联的组织，最多支持100个数字人ID
2、接口支持https协议

介面URL

http://api.polyv.net/live/v4/ai/digital-human/list-organization

線上API呼叫

請求方式

GET

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數描述

參數名	必選	類型	說明
appId	true	String	帳號appId【詳見取得金鑰】
timestamp	true	Long	目前13位毫秒級時間戳記，3分鐘內有效
sign	true	String	簽名，為32位大寫的MD5值，`產生簽名的appSecret金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料`【詳見簽名產生規則】
aiDigitalHumanIds	true	String	數位人ID，多個用英文逗號隔開，最多100個ID

範例

http://api.polyv.net/live/v4/ai/digital-human/list-organization?appId=frlr1zacn3&sign=0F412B15C2DC032517E1D29BD4452C43&timestamp=1630996829815&aiDigitalHumanIds=1,2,3

回應參數描述

參數名	類型	說明
code	Integer	回應狀態碼，200為成功返回，非200為失敗
status	String	回應結果，由業務決定，成功返回success，失敗返回error
success	Boolean	回應結果，由業務決定，成功返回true，失敗返回false
data	List<AIDigitalHumanOrganizationVO>	成功回應時返回頻道詳細資訊【詳見data欄位說明】
error	Object	狀態碼非200時的錯誤資訊【詳見Error欄位說明】
requestId	String	請求ID，每次請求產生的唯一的 UUID，僅可用於排查、除錯，不應該和業務掛鉤

Error參數描述

參數名	類型	說明
code	Integer	錯誤代碼，用於確定具體的錯誤原因
desc	String	錯誤描述，與 error.code 對應

data參數描述

AIDigitalHumanOrganizationVO

參數名	類型	說明
aiDigitalHumanId	Integer	數位人ID
organizationIds	List<Integer>	組織ID列表
includeChildren	Boolean	是否包含子節點

回應範例

成功範例

{
    "code": 200,
    "status": "success",
    "requestId": "dc7ae621ef8e4f4a8e4976833f1dbbd4.66.16309975070362179",
    "data": [
        {"aiDigitalHumanId":1,"organizationIds":[1,2,3],"includeChildren":true},				
        {"aiDigitalHumanId":2,"organizationIds":[3,4,5],"includeChildren":false}
    ],
    "success": true
}

異常範例

{
    "code": 400,
    "status": "error",
    "requestId": "d310b70bc329403f87f77f9203d50f89.128.16360828899123425",
    "success": false
}