前言¶

对接用友 YonBIP 旗舰版的开放平台接口时，常见的时间消耗不在业务字段，而在鉴权：先用应用凭证算签名换 token，再把 token 作为 query 参数拼进网关地址，字段名、签名方式、参数位置错一处，返回的就是鉴权类报错，且错误信息往往不告诉你错在哪一步。

下面介绍的 Skill「用友BIP旗舰版API接口测试」就是把这条链路固化成可复用的调用规范，让 Agent 按固定步骤完成取 token 与业务接口联调。

这是什么¶

这是一个社区来源的 Skill，坐标 @user_3d743042/yonyou-js-djw-api-ult，版本 2.4.0，由 user_3d743042 发布，分类 dev-programming，带 requires_api_key=true 标签。

它解决的问题是：在 Agent 里调用 YonBIP 旗舰版（IUAP 开放平台）业务接口时，如何正确地完成鉴权并发起请求。Skill 只提供调用规范与流程，不内置任何凭证或业务数据。

核心功能¶

1、以应用的 appKey / appSecret 换取 access_token，签名算法为 HmacSHA256。
2、拿到 access_token 后，以网关 query 参数的形式携带，调用开放平台业务接口。
3、覆盖业务接口联调场景，并可用于排查鉴权类报错：按「取 token → 拼 token → 调业务接口」的顺序逐段定位。

安装与启用¶

抓取到的官方资料只包含该 Skill 的元数据与简介，没有给出安装命令、目录约定或客户端差异说明。

该 Skill 基于通用 SKILL.md 格式，因此实际放置方式取决于你使用的客户端：先把官方地址 https://api.skillhub.cn/user_3d743042/yonyou-js-djw-api-ult 对应的 Skill 拉取到本地，再按客户端的 Skill 加载方式注册。安装命令与路径请以官方页面当前给出的内容为准，本文不代写未经核实的命令。

启用后按自然语言触发即可，例如「调用旗舰版开放平台接口」「获取 access_token」「业务接口联调」「排查鉴权报错」。

典型用法¶

下面这段流程来自官方简介，展示了 Skill 固化的调用顺序。

1、准备应用凭证：由调用方提供 appKey 与 appSecret。这一步的输入来自用户，Skill 不保存、不回显凭证。

2、换取 access_token：用 appKey / appSecret 按 HmacSHA256 生成签名，向开放平台换取 access_token。

3、调用业务接口：把 access_token 作为网关地址的 query 参数拼上，再发起业务接口请求。

4、排查鉴权报错：当返回鉴权失败时，按上面的顺序逐段检查——签名算法是否为 HmacSHA256、token 是否放在 query 参数而非请求体、业务接口是否与该 token 的权限范围匹配。

适用场景与注意¶

适合需要以程序方式调用 YonBIP 旗舰版开放平台接口、或已经在联调期需要快速定位鉴权问题的场景。

需要注意的两点：一是凭证必须由使用者自己提供，Skill 的知识包内不含 appKey / appSecret，也不随包外发；二是接口实体数据同样由用户提供，Skill 只负责调用流程与规范，不会内置租户、组织或业务数据。

小结¶

这个 Skill 的价值在于把 YonBIP 旗舰版开放平台的鉴权链路收敛成固定步骤，减少在签名与 token 传递环节反复试错的时间。

官方地址：https://api.skillhub.cn/user_3d743042/yonyou-js-djw-api-ult