通过调用本接口，开发者可以在外部系统中使用百宝箱提供的插件工具。
请求地址
POST``https://api.tbox.cn/api/plugin/invoke
请求头
| 参数名 | 必填 | 类型 | 说明 | 示例 |
|---|
| Authorization | 是 | String | 用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。 | pat_2j4e******THUIVRH1 |
请求参数
| 参数名 | 必填 | 类型 | 说明 | 示例 |
|---|
| pluginToolId | 是 | String | 工具 ID，由查询官方插件列表接口获取。 | - |
| params | 是 | Map<String, Object>- key: 参数名 value：参数值 | 工具调用所需参数，由查询官方插件列表接口获取。 | - |
请求示例
curl --location 'https://api.tbox.cn/api/plugin/invoke'
--header 'Authorization: {your_token}'
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--data '{
"pluginToolId":{pluginToolId},
"params": {
"q": "xxx"
}
}'
返回参数
| 参数名 | 类型 | 说明 | 示例 |
|---|
| errorCode | String | 错误码，为 0 表示成功。 | 0 |
| errorMsg | String | 错误信息。 | success |
| data | ToolResponse | 插件调用结果详情。 | - |
| traceId | String | 本次请求的唯一标识，通常用于发生错误时的排查定位。 | 0b****4d9 |
data 定义
| 参数名 | 类型 | 说明 |
|---|
| success | Boolean | 是否调用成功 |
| response | Object | 工具响应结果，结构请参考查询官方插件列表接口获取的工具输出参数定义。 |
返回示例
成功示例
{
"data": {
"response": {
"msg": "操作成功",
"code": 0,
"data": [
{
"hostName": "",
"publishTime": "1755355752",
"extra": {
"extraUrl": "https://www.jinjia.com.cn/",
"domain": "quark",
"sort": 0,
"extraTitle": "金价网-今日金价查询表"
},
"channel": "quark",
"articleId": "quark_f9bc6e9d934638a361ec0bc85042aef2",
"title": "金价网-今日金价查询表",
"url": "https://www.jinjia.com.cn/",
"desc": "金价网是一个专业的黄金价格查询平台，提供黄金市场行情，包括国际国内黄金、今日金价、上海黄金、银行黄金价格、香港黄金价格行情行情等内容，全力为广大投资者提供黄金的信息服务。"
},
{
"hostName": "",
"publishTime": "1755579111",
"extra": {
"extraUrl": "https://www.jinrijinjia.cn/",
"domain": "quark",
"sort": 1,
"extraTitle": "今日黄金价格查询_现在金价黄金多少钱一克_国际金价实时行情_黄金金价网"
},
"channel": "quark",
"articleId": "quark_c1643b6a5b01737aa37ff505fcdee306",
"title": "今日黄金价格查询_现在金价黄金多少钱一克_国际金价实时行情_黄金金价网",
"url": "https://www.jinrijinjia.cn/",
"desc": "国内金价 778.61 -9.58 -1.22% 788.30 777.00 788.00 788.19 克/人民币 国内银价 9388.00 -87.00 -0.92% 9498.00 9355.00 9474.00 9475.00 千克/人民币 24小时黄金实时快讯 2025年7月23日黄金价格多少钱一克今日查询"
},
{
"hostName": "",
"publishTime": "1755404286",
"extra": {
"extraUrl": "http://guojijinjia.com/",
"domain": "quark",
"sort": 2,
"extraTitle": "国际金价_今日金价实时行情最新黄金价格查询"
},
"channel": "quark",
"articleId": "quark_bf6d40e5c901948bc8c67979df037da5",
"title": "国际金价_今日金价实时行情最新黄金价格查询",
"url": "http://guojijinjia.com/",
"desc": "伦敦金价现货走势图纽约黄金期货走势图中国上海黄金走势图今日国际金价行情使用说明提供今天黄金即时价格走势查询，实时报价更..."
},
{
"hostName": "",
"publishTime": "1755273600",
"extra": {
"extraUrl": "http://www.huangjinjiage.cn/golden/113761.html",
"domain": "quark",
"sort": 3,
"extraTitle": "国内金价实时查询（24小时行情走势图|回收价格|今日价格）金价查询网"
},
"channel": "quark",
"articleId": "quark_20c83ec8f20e02af69f8ca74b3e828d7",
"title": "国内金价实时查询（24小时行情走势图|回收价格|今日价格）金价查询网",
"url": "http://www.huangjinjiage.cn/golden/113761.html",
"desc": "国内金价今日多少钱一克？提供国内金价实时查询、国内金价行情走势图、国内金价回收多少钱一克、国内金价最低多少钱一克等国内金价今天什么价格查询。今日国内金价实时查询黄金品种回收价格销售..."
},
{
"hostName": "",
"publishTime": "1755273600",
"extra": {
"extraUrl": "http://www.huangjinjiage.cn/jinrijinjia.html",
"domain": "quark",
"sort": 4,
"extraTitle": "今日金价（实时更新）黄金价格今日多少钱一克_金价查询网"
},
"channel": "quark",
"articleId": "quark_0cc918acaf7b8c7ef28607741439a2c1",
"title": "今日金价（实时更新）黄金价格今日多少钱一克_金价查询网",
"url": "http://www.huangjinjiage.cn/jinrijinjia.html",
"desc": "本页面提供今日金价在线查询，包括国际金价、国内金价、今日金价、上海黄金价格、银行黄金价格、金店黄金价格、黄金回收价格等实时行情报价。黄金价格今日实时报价名称卖出价格今日价格最高价格最低价格价格..."
},
{
"hostName": "",
"publishTime": "1755273600",
"extra": {
"extraUrl": "http://www.huangjinjiage.cn/quote/113124.html",
"domain": "quark",
"sort": 5,
"extraTitle": "金价国际今日价格（走势图|24小时实时|金条价格|回收）金价查询网"
},
"channel": "quark",
"articleId": "quark_cbf5cbd99ca272cf052d5bc5b8bb1541",
"title": "金价国际今日价格（走势图|24小时实时|金条价格|回收）金价查询网",
"url": "http://www.huangjinjiage.cn/quote/113124.html",
"desc": "提供黄金金价国际今日价格在线查询，通过走势图实时了解金价的变化，还提供金条价格和回收价格的最新报价查询，无论你是购买黄金、投资黄金还是回收黄金，在这里都可以查到实时金价行情。金价..."
}
],
"success": true
}
},
"errorCode": "0",
"errorMsg": "success",
"traceId": "0be8*******e477"
}
失败返回
{
"errorCode": "P_1_03_200",
"errorMsg": "必传参数缺少参数值",
"solution": ""
}
错误码
公共错误码
| errorCode | errorMsg | 说明 |
|---|
| S40000 | 系统异常 | - 原因：系统出现错误。 解决方案：请稍后重试，若持续报错，请点击此处与我们取得联系，并将错误码与 traceId 一同反馈，帮助我们快速定位问题。 |
| P_1_10_183 | 授权令牌无效 | - 原因：token 不正确。 解决方案：请校验是否输入了有效令牌或配置新令牌。 |
| P_1_10_184 | 授权令牌已失效 | - 原因：当前 token 已过期。 解决方案：请前往百宝箱开放平台申请新令牌并更新到调用配置中。 |
| P_1_10_185 | 未检测到授权令牌 | - 原因：未填写 token 信息 解决方案：请参考授权管理完成授权令牌的申请和配置。 |
| P_1_13_682 | 非法访问，请联系平台 | - 原因：系统检测到异常活动。 解决方案：请稍后重试，若持续报错，请点击此处与我们取得联系，并将错误码与 traceId 一同反馈，帮助我们快速定位问题。 |
参数校验与业务错误码
| errorCode | errorMsg | 说明 |
|---|
| P_1_00_005 | 不合法的插件类型 | - 原因：查询官方插件列表插件类型参数不合法 解决方案：确认插件类型参数是否在合法枚举值内- - 实用工具：UTILITY_TOOL生活服务：LIFE_SERVICE 内容搜索：CONTENT_SEARCH MCP工具：MCP_TOOL |
| P_1_02_111 | 工具不存在或已下架 | - 原因：调用的工具不存在或已下架 解决方案：请检查入参 pluginToolId 是否正确 |
| P_1_02_111 | 插件不存在或已下架 | - 原因：调用的工具所属插件不存在或已下架 解决方案：请检查入参 pluginToolId 是否正确 |
| P_1_02_111 | 该工具不支持通过openapi/sdk调用 | - 原因：该工具不支持通过 openapi/sdk 调用 解决方案：请检查入参 pluginToolId 是否正确 |
| P_1_03_200 | 必传参数缺少参数值 | - 原因：工具必传入参未填 解决方案：确认必传参数都已传值 |
| P_1_03_200 | 参数值超出枚举范围 | - 原因：工具参数值超出枚举范围 解决方案：确认参数值在枚举值范围内 |
