🔦
服务端接口签名算法说明

🏹

本文档用于指导第三方开发者完成探鸽平台账号服务接入，以及平台服务端 API 的签名认证对接。​

无论您选用平台内置账号体系，还是对接自有账号系统，平台均会为每一位用户下发具备时效属性的 User Token（access_token），作为后续所有业务接口调用的身份校验凭证。​

1.
服务端API接口签名算法Demo​

本章节提供多语言版本的接口签名认证代码 Demo，可直接参考实现签名、验签逻辑，快速完成对接开发。​

• Java版本示例（JDK6以上）下载解压 javac -encoding UTF-8 Main.java java Main	java.zip 81.37KB
• PHP语言示例（PHP8以上）下载直接运行 php main.php	php.zip 5.13KB
• Golang语言示例(1.16版本以上) 下载直接运行 go run main.go	main.go 13.41KB
• JavaScript语言示例下载直接运行 Node main.js	main.js 6.96KB

2.
自有账号体系调用流程​

如果您拥有自己的账号体系，需在用户登录完成后，通过平台提供的接口，将自有账号信息与探鸽平台进行关联。​

流程图

3.
自有账号登录接口详解​

3.1
接口核心作用​

若开发者已搭建自有账号体系，可通过本接口传入自有系统内用户的唯一标识符（user_id，需开发者保证唯一性，长度不超过 32 字符），平台将自动建立 “开发者自有账号” 与 “TIVS 平台内部账号” 的一一映射关系，并返回该用户对应的授权令牌（access_token），用于后续接口鉴权。​

3.2
调用限制​

•
仅限开发者服务器调用，禁止在客户端调用​

•
接口启用服务器白名单检测，需提前配置合法服务器 IP​

3.3
access_token 用途​

获取的 access_token 需放入后续客户端API（API_FOR_CLIENT） 请求的 Authorization 请求头中，作为接口鉴权的核心凭证。(注意：所有服务端API（API_FOR_SERVER）接口是验证签名)​