查询 AISearch 结构化资源时，当前支持的资源类型包括：【小程序】（miniapp）和【商品】（product）。 资源类型为必填参数；若提供资源 ID，则查询指定资源；若未提供资源 ID，则按分页方式查询该类型下的全部资源。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /api/v1/aiSearch/resource/list HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| type |
string |
是 |
结构化元素类型 枚举值：
|
miniapp |
| resourceIds |
array |
否 |
待查询的资源列表，若为空则按分页方式查询该类型下的全部资源 |
|
|
string |
否 |
结构化元素资源 ID，是该资源在数据库中唯一且不可变的标识符 |
WzMGQZwB7nQEs3Qk3ajH |
|
| pageSize |
integer |
否 |
分页大小，默认 20 |
20 |
| currentPage |
integer |
否 |
分页页码，从 1 开始 |
1 |
字段 type 本质上为枚举类型，仅支持规定的取值范围，超出范围的值将导致接口无法正常工作；后续将根据需求扩展更多结构化内容。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
Id of the request |
A8AEC6D9-A359-5169-BD1A-BD848BA60D65 |
| data |
object |
返回结果。 |
|
| total |
integer |
资源总数 |
68 |
| currentPage |
string |
当前页码。 |
1 |
| pageSize |
string |
分页大小 |
20 |
| items |
array |
资源列表 |
|
|
any |
Item 详情 |
{"type":"miniapp","score":0.4571971,"resourceId":"1512004139024243527680","miniappId":"","title":"Electronic Invoice","version":"1.0.0","description":"The E-Invoice mini-app supports setting up email/SMS delivery, querying issuance records, requesting and reissuing invoices, and downloading or printing PDF files.","slogan":"E-Invoice mini-app","icon":"https://gw.alicdn.com/6000000000498-2-tps-200-200.png","url":"https://app-intl.com/release/6592_v1.6.16_poc.zip","detailDescription":null} |
示例
正常返回示例
JSON格式
{
"requestId": "A8AEC6D9-A359-5169-BD1A-BD848BA60D65",
"data": {
"total": 68,
"currentPage": "1",
"pageSize": "20",
"items": [
" {\"type\":\"miniapp\",\"score\":0.4571971,\"resourceId\":\"1512004139024243527680\",\"miniappId\":\"\",\"title\":\"Electronic Invoice\",\"version\":\"1.0.0\",\"description\":\"The E-Invoice mini-app supports setting up email/SMS delivery, querying issuance records, requesting and reissuing invoices, and downloading or printing PDF files.\",\"slogan\":\"E-Invoice mini-app\",\"icon\":\"https://gw.alicdn.com/6000000000498-2-tps-200-200.png\",\"url\":\"https://app-intl.com/release/6592_v1.6.16_poc.zip\",\"detailDescription\":null}"
]
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。