作者:张振琦
之前写了API v2的使用介绍,发现API v1的接口也可能会用到,那就把这块也补上来。现在就来看看API v1 是如何使用的。
Udesk 开放接口(v1)的调用地址符合以下格式:
https://[子域名].udesk.cn/api/[版本]/[接口相对地址]?[Query String]&sign=[签名]
变量 | 说明 |
---|---|
子域名 | 您使用 Udesk 客服系统时,分配给您的子域名 |
版本 | 接口的版本。Udesk 开放接口(v1)有过一次小的升级,所以该值可能是 v1 或 v2,分别代表1.1版和1.2版 |
接口相对地址 | 接口的相对地址 |
Query String | 地址的参数部分,该部分要参与签名计算 |
签名 | 身份验证签名 |
API v1的URL参数比API v2的要简单简单一些,除了服务必须的参数,就只需添加一个签名。API v1 所有接口调用需要携带签名参数 sign,只有当 sign 值合法时请求才会被接受。
sign 的计算方法如下:
sign=MD5(QueryString + “&” + Secret)
其中:
1.QueryString 为URL中的参数(不包含参数 sign),