接口规范

更新时间:2025-05-30 01:56:03下载pdf

1 header参数约定

任何接口需要在header中加入如下参数:

参数名 类型 必填 描述
client_id String 涂鸦智能平台提供的client_id
sign String 采用指定签名算法计算出的签名
sign_method String 签名的摘要算法,固定填写HMAC-SHA256
t Long 13位标准时间戳
access_token String 业务接口必传,token相关接口不传
lang String 语种,默认中文(中文:zh;英文:en;日语:ja;韩语:ko)

1.1 签名方式

涂鸦云根据不同应用场景,提供两套两套签名算法:

token相关接⼝:(如v1.0/token或v1.0/token/{refresh_token}):sign = HMAC-SHA256(client_id + t, secret).toUpperCase())

业务接口(非token接⼝):

sign = HMAC-SHA256(client_id + access_token + t, secret).toUpperCase() 

2021年07月01日开始变更成:

token相关接口:sign = HMAC-SHA256(client_id+t+nonce+stringToSign, secret).toUpperCase()

业务相关接口:

str = client_id + access_token + t + nonce + stringToSign
sign = HMAC-SHA256(str, secret).toUpperCase()

对于nonce、stringToSign、str的计算方式请看:签名方式