# 易数链动开放平台

仅供外部应用的 HMAC 接入资料。协议 1.0，服务端 JSON 调用。

- 入口：POST https://www.yishuld.com/api/v1/open/invoke
- 公开文档：https://open.yishuld.com/
- 接入签名与授权：https://open.yishuld.com/#authentication
- 外部 OpenAPI：https://open.yishuld.com/openapi.json
- 对外操作及字段目录：https://open.yishuld.com/catalog.json
- 签名测试向量：https://open.yishuld.com/signature-vector.json
- 上游价格规则：https://open.yishuld.com/#pricing
- 工具与 SDK：https://open.yishuld.com/#tools
- 全接口调用 Skill 安装：https://open.yishuld.com/#skills
- 应用授权状态：https://www.yishuld.com/ysld-merchant/merchant/api-access

调用信封为 version、operation、params。不能将内部 Bearer、App 用户 token 或供应商密钥用作商户 HMAC。
签名按实际发送的 UTF-8 请求体字节计算，空查询行仍占一行，时间戳为秒，无末尾换行。
每次 HTTP 请求需要新 nonce；业务幂等键或原订单号保持稳定。不得对结果未知的写操作盲目重试或更换业务键。
CLI 默认预览；真正调用需要 --execute，写操作还需 --allow-write。这不授予任何服务端权限。
目录存在不代表应用已授权、供应商已配置或处于模拟环境。商户不能自行开通 API 权限。
不要索取或将密钥写入聊天、日志、源码或浏览器；SDK 在调用方服务端使用。
本版本保留各业务原有字段及单位，不宣称供应商中立业务模型已经统一。响应原文应无损保留长整数和精确金额。

上游默认加价率按结算成本计算，同一上游的商户共用比例。当前提供规则管理和试算，交易计价状态为 AWAITING_COST_BINDING，不改变原透传金额或账单。不要使用面值、展示价、预估价替代成本。

完整 Skill： https://open.yishuld.com/skills/ysld-open-platform/SKILL.md
技能安装包： https://open.yishuld.com/downloads/ysld-open-platform-skill.zip
包内每个 operation 均有独立字段说明、请求示例和调用命令。