Udesk API v1 使用介绍（一）

最新推荐文章于 2025-10-01 16:38:43 发布

原创

最新推荐文章于 2025-10-01 16:38:43 发布 · 1k 阅读

0 ·

CC 4.0 BY-SA版权

本文介绍了Udesk API v1的调用格式和签名计算方法。API v1的URL参数包括签名sign，其计算涉及QueryString和Secret，Secret可在在线客服系统后台获取。调用步骤包括获取Secret、拼接URL参数、计算sign并添加至URL。文章预告将展示Java调用API v1的实现。

作者：张振琦

之前写了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），格式为“&”分割的“key=value”字符串，顺序为参数在调用地址中的顺序；
2.Secret 为单点登录共享秘钥，您可以