赟市开放API 1.0上线

接口加签验签

适用范围

所有以下前缀接口： https://www.yunshi-life.com/v1/

参数形式

接口都是以POST方法请求一个完整的JSON对象（不是JSON 字符串）

body.data是完整的业务参数

body.data是JSON对象，不是JSON字符串

body.data内层复杂对象类型请参考API文档（绝大多数是字符串类型）

详细样例，请参考具体文档或者下文例子

body.data携带完整业务参数，第一层是基本类型（String、Int），没有复杂类型JSON

body.data第一层所有传递的参数者参与签名
如果出现多层嵌套，那么以JSON字符串形式传递。例如下文的terminal_device_info

如何加签

仅对body.data中的内容进行加签。

1.

body.data中的数据，去掉换行、空格等格式字符后，按照参数字典顺序排序生成字符串（参数名ASCII码从小到大排序（字典序）；参数名区分大小写；）以上文为例排序后

注：如果是JSON字符串，不需要进行排序，例如terminal_device_info的value不用排序

2.

对第一步生成的字符串结合您的私钥进行加签；注：如果你有自己的私钥可以用自己的。如果没有参见联调公私钥参数获取一节说明

3.

先对该json对象数据按照参数字典顺序（参数名ASCII码从小到大排序，参数名区分大小写）排序生成字符串，再进行加签和验签。
JSON数据排序代码示例

java代码示例

python代码示例

PHP代码示例

C#代码示例

4.

签名代码示例如下

java代码示例

python代码示例

PHP代码示例

C#代码示例

TIP：您可以通过斗拱CLI工具提供的verify_sign命令验证生成的签文是否正确；

如何验签

仅对data中的内容进行验签

1.

data中的数据，同步返参按照参数字典顺序排序生成字符串，异步返参不需要排序。
以上文为例排序后

注：如果是JSON字符串，不需要进行排序，例如terminal_device_info不用排序；

2.

对第一步生成的字符串结合斗拱平台公钥进行验签

3.

验签示例如下

java代码示例

python代码示例

PHP代码示例

C#代码示例

修改于 2026-01-09 08:07:48