Query Digital Human Organization
Updated: 2026-07-13 11:57:31
API Description
1、查询数字人关联的组织，最多支持100个数字人ID
2、接口支持https协议
API URL
http://api.polyv.net/live/v4/ai/digital-human/list-organization
Request Method
GET
API Constraints
- The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details
Request Parameter Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| appId | true | String | Account appId See details: Get Secret Key |
| timestamp | true | Long | Current 13-digit millisecond timestamp, valid within 3 minutes |
| sign | true | String | Signature, a 32-character uppercase MD5 value. The appSecret key used to generate the signature is critical for communication data security. It must not be stored or used directly on the client side. All APIs must be called through the customer's own server to relay requests to the POLYV server for response data. See details: Signature Generation Rules |
| aiDigitalHumanIds | true | String | Digital human IDs, separated by commas for multiple IDs, up to 100 IDs |
Example
http://api.polyv.net/live/v4/ai/digital-human/list-organization?appId=frlr1zacn3&sign=0F412B15C2DC032517E1D29BD4452C43×tamp=1630996829815&aiDigitalHumanIds=1,2,3
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Response status code, 200 for success, non-200 for failure |
| status | String | Response result, determined by business logic: success returns "success", failure returns "error" |
| success | Boolean | Response result, determined by business logic: success returns true, failure returns false |
| data | List<AIDigitalHumanOrganizationVO> | Returns channel details on successful response See details: data field description |
| error | Object | Error information when status code is non-200 See details: Error field description |
| requestId | String | Request ID, a unique UUID generated for each request, used only for troubleshooting and debugging, not related to business logic |
Error Parameter Description
| Parameter | Type | Description |
|---|---|---|
| code | Integer | Error code, used to identify the specific error reason |
| desc | String | Error description, corresponding to error.code |
Data Parameter Description
AIDigitalHumanOrganizationVO
| Parameter | Type | Description |
|---|---|---|
| aiDigitalHumanId | Integer | Digital human ID |
| organizationIds | List<Integer> | List of organization IDs |
| includeChildren | Boolean | Whether to include child nodes |
Response Example
Success Example
{
"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
}
Error Example
{
"code": 400,
"status": "error",
"requestId": "d310b70bc329403f87f77f9203d50f89.128.16360828899123425",
"success": false
}
