Skip to main content

交互协议

交互协议https
url正式环境地址
https://api.ykyrtbsz.qq.com/{version}/get_ads
沙箱环境地址
https://sandbox.api.ykyrtbsz.qq.com/{version}/get_ads
1、version 字段取值说明：
version 取自于接入的协议文档的大版本号，比如说协议文档是 v2.1.6 那么 version = v2， 有疑问可联系游可赢技术客服进行沟通处理；
2、建议使用沙箱环境广告请求API进行开发，方便后续跟游可赢一起定位问题
methodPOST
Content-Typeapplication/json
header请求头必须传入 timestamp、nonce、sign 三个请求头
timestamp请求头
精确到毫秒的时间戳，13 位，会做时效性校验，请按真实时间填写。比如：1629968907123
nonce请求头
随机数，不超过 long 最大值且 1 小时内不能重复，比如：12345
sign请求头
签名方法详见下述说明
编码utf-8
API格式json

 HTTP 请求 header sign 字段计算方法：

加密方法SHA1加密
加密字段secret_key : 密匙，可通过商务同学获取，该密匙贯穿整个路径里面的加解密，请妥善保管，谨防泄漏
timestamp, nonce 取自于 header 里面的字段，这三个字段转为字符串之后升序拼接，然后进行 SHA1加密
加密示例// golang 示例
signParam := []string{secret_key,timestamp,nonce}
// increasing
sort.Strings(signParam)
SHA1(strings.Join(signParam, ""))
func SHA1(s string) string {
o := sha1.New()
o.Write([]byte(s))
return hex.EncodeToString(o.Sum(nil))
}