百宝箱开放平台 ✖️ 调用插件工具

支付宝小程序云2025-10-09 16:08

通过调用本接口，开发者可以在外部系统中使用百宝箱提供的插件工具。

请求地址

POST``https://api.tbox.cn/api/plugin/invoke

请求头

参数名 必填 类型 说明 示例
Authorization 是 String 用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。 pat_2j4e******THUIVRH1

请求参数

参数名 必填 类型 说明 示例
pluginToolId 是 String 工具 ID，由查询官方插件列表接口获取。 -
params 是 Map<String, Object>- key: 参数名 value：参数值 工具调用所需参数，由查询官方插件列表接口获取。 -

请求示例

css 复制代码 
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 工具响应结果，结构请参考查询官方插件列表接口获取的工具输出参数定义。

返回示例

成功示例

json 复制代码 
{
    "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"
}

失败返回

json 复制代码 
{
    "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 参数值超出枚举范围 - 原因：工具参数值超出枚举范围 解决方案：确认参数值在枚举值范围内
相关推荐
聚客AI5 小时前
🌈提示工程已过时？上下文工程从理论到实践的完整路线图
人工智能·llm·agent
大模型教程6 小时前
AI Agent竞争的下半场：决胜关键不在模型，而在系统架构
程序员·llm·agent
大模型教程8 小时前
基于DeepSeek-R1手搓AI Agent智能体（手把手，个人电脑也能玩）
程序员·llm·agent
AI大模型8 小时前
基于Qwen千问实现自然语言数据分析AI Agent智能体（手把手，个人电脑也能玩哦）
程序员·llm·agent
AI大模型8 小时前
构建完全本地的MCP客户端：让AI智能体与数据库无缝对话
程序员·agent·mcp
EdisonZhou12 小时前
多Agent协作入门：基于A2A协议的Agent通信（中）
aigc·agent·.net core
AI大模型1 天前
斩获59.4K星！一款本地部署的开源私人知识库工具！
程序员·llm·agent
大模型教程1 天前
GitHub 上 6 万人收藏！RAG 引擎让知识库活起来
程序员·llm·agent
许泽宇的技术分享2 天前
微软Agent框架深度解析：重新定义AI应用开发的革命性架构
microsoft·agent
热门推荐
01两千字总结：Codex 国内如何安装和使用的教程，以及如何设置中文回答02GitHub 镜像站点03UV安装并设置国内源04KGG转MP3工具|非KGM文件|解密音频05Linux下V2Ray安装配置指南06jdk21下载、安装（Windows、Linux、macOS）07DeepSeek-VL 解析：混合视觉-语言模型如何超越传统计算机视觉方法08一文了解国产算子编程语言 TileLang，TileLang 对国产开源生态的影响与启示09Claude Code & 智谱GLM-4.5 环境配置指南 (Windows/macOS/Ubuntu)1046个Nano-banana 精选提示词，持续更新中