查询skill信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Keyword |
string |
否 |
技能名称、技能描述中的关键词。 |
weather |
| Type |
string |
否 |
技能类型。 枚举值：
|
System |
| PageNumber |
integer |
否 |
分页参数：当前页码，默认值 1。 |
1 |
| PageSize |
integer |
否 |
每页显示的条数，默认为 10 条，最大为 100 条。 |
10 |
| Language |
string |
否 |
语言类型。技能描述将以此语言返回。
枚举值：
|
zh-CN |
| SkillId |
string |
否 |
技能 ID。 |
sk-051j4pbwxzgol**** |
| StatusFilter |
string |
否 |
状态筛选。 枚举值：
|
UPLOADED |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
PlainResult |
||
| RequestId |
string |
请求 ID。 |
1A923337-44D9-5CAD-9A53-95084BD4**** |
| Code |
string |
状态码。返回 200 表示成功。 |
200 |
| Message |
string |
接口返回信息。 |
Success. |
| TotalCount |
string |
总条目数。 |
10 |
| SkillInfo |
array<object> |
技能信息。 |
|
|
array<object> |
技能信息。 |
||
| SkillId |
string |
技能 ID。 |
s-04zzrgosj6xd1**** |
| SkillName |
string |
技能名称。 |
weather |
| Type |
string |
技能类型。 |
System |
| Status |
string |
技能状态。 |
active |
| Description |
string |
技能描述。 |
Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning. |
| Instruction |
string |
技能摘要。 |
Current weather and forecasts. |
| IconOssUrl |
string |
技能图标 OSS 下载链接。 |
aHR0cDovL2Nsb3VkLXBob25lLWFpLXRlc3QwLm9zcy1jbi1oYW5nemhv**** |
| CreateTime |
string |
创建时间。 |
2026-03-13 15:40:51 |
| Version |
string |
技能版本号。 |
1.0.0 |
| Category |
string |
技能分类。 |
System |
| SkillStatus |
string |
技能生命周期状态。 |
UPLOADED |
| SkillSource |
string |
技能来源。 枚举值：
|
USER_UPLOAD |
| SourceInstanceId |
string |
对话创建的技能的来源节点 ID（用户上传为空）。 |
acp-bp4du4v74mc7qw8**** |
| InstalledCount |
integer |
已安装该技能的实例数量。 |
10 |
| InstalledInstances |
array<object> |
安装的实例信息。 |
|
|
object |
安装的实例信息。 |
||
| InstanceId |
string |
云手机实例 ID。 |
acp-6g3nocu5y9vaf**** |
| InstallStatus |
string |
安装状态。 |
INSTALLED |
示例
正常返回示例
JSON格式
{
"RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
"Code": "200",
"Message": "Success.",
"TotalCount": "10",
"SkillInfo": [
{
"SkillId": "s-04zzrgosj6xd1****",
"SkillName": "weather",
"Type": "System",
"Status": "active",
"Description": "Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.",
"Instruction": "Current weather and forecasts.",
"IconOssUrl": "aHR0cDovL2Nsb3VkLXBob25lLWFpLXRlc3QwLm9zcy1jbi1oYW5nemhv****",
"CreateTime": "2026-03-13 15:40:51",
"Version": "1.0.0",
"Category": "System",
"SkillStatus": "UPLOADED",
"SkillSource": "USER_UPLOAD",
"SourceInstanceId": "acp-bp4du4v74mc7qw8****",
"InstalledCount": 10,
"InstalledInstances": [
{
"InstanceId": "acp-6g3nocu5y9vaf****",
"InstallStatus": "INSTALLED"
}
]
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。