通过调用本接口,开发者可以在外部系统中使用百宝箱提供的插件工具。
请求地址
POSThttps://api.tbox.cn/api/plugin/invoke
请求头
参数名 |
必填 |
类型 |
说明 |
示例 |
Authorization |
是 |
String |
用于验证客户端身份的访问令牌,你可以在百宝箱中获取,获取方式可参见:授权管理。 |
|
请求参数
请求示例
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 |
插件调用结果详情,详细说明可参见:data 定义。 |
- |
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 |
系统异常 |
|
P_1_10_183 |
授权令牌无效 |
|
P_1_10_184 |
授权令牌已失效 |
|
P_1_10_185 |
未检测到授权令牌 |
|
P_1_13_682 |
非法访问,请联系平台 |
|
参数校验与业务错误码
errorCode |
errorMsg |
说明 |
P_1_00_005 |
不合法的插件类型 |
|
P_1_02_111 |
工具不存在或已下架 |
|
P_1_02_111 |
插件不存在或已下架 |
|
P_1_02_111 |
该工具不支持通过openapi/sdk调用 |
|
P_1_03_200 |
必传参数缺少参数值 |
|
P_1_03_200 |
参数值超出枚举范围 |
|