跳到主要内容

RTA对接文档

修订历史​

文档版本修订日期修订描述
1.0.02024-10-04文档新建

[TOC]

RTA请求

请求协议​

  1. 平台将给出rta请求地址如: http://xxx/bid?mid=1003
  2. 与平台约定 请求channel id 与 密钥secret
  3. 设置协议头
  • ContentType: application/json
  • X-RTA-ID: RTA当次请求id，推荐使用时间戳，全局唯一请求id
  • X-RTA-SECRET: 验证字符串 通过密钥 与 X-RTA-ID 生成
  • X-RTA-SECRET = lowerCase(Md5(X-RTA-ID + Secret)) (md5后转小写)
  1. 使用http post协议请求RTA地址.
  2. 获取RTA命中信息

Request字段​

参数名是否必填类型描述备注 / 例子
req_id是string请求id，请求方生成1616368967
channel_id是string平台分配的位置id1234
rta_ids是[]string 数组需要请求的rtaids，平台获取["51","52","53"]
imei否string设备imei原值安卓需要imei,andorid_id,oaid，原值或者md5 至少有一项
imei_md5否string设备imei原值md5后转大写
android_id否string设备andoridid原值
android_id_md5否string设备andoridid原值md5后转大写
oaid否string设备oaid原值
oaid_md5否string设备oaid原值md5后转大写
idfa否string设备idfa原值IOS需要idfa,caid，原值或者md5 至少有一项
idfa_md5否string设备idfa原值md5后转大写
caid否string设备caid版本号+caid原值,中间下划线分隔2022_12313213132
caid_md5否string设备caid版本号+caid原值md5后转大写,中间下划线分隔2022_752AE33A5583BEFA6DB8A36BF183E1F5
caids否[]string 数组其他版本caid版本+原值
os否int设备操作系统0：未知，1：ios，2：安卓
osv否string设备操作系统版本号13.1.1
ip否string设备ip
ua否string设备ua
brand否string设备品牌
model否string设备机型

请求Example​

{
    "req_id": "070c9ee9-3ef3-4577-95ce-75d6af626f82",
    "channel_id":"30001",
    "rta_ids":["10"],
    "oaid_md5":"001CDCB9B51148DCACE22AA713D0FDCC"
}

RTA响应

响应格式​

响应http code 200

body为空，code不为0，rta_ids为空， 均为未命中。

Response字段​

参数名是否必填类型描述备注 / 例子
code是int错误码,0为请求成功，非0表示请求错误或未命中
req_id否string请求id
rta_ids否[]string数组本次命中的rta id["51","52"]

响应Example​

{
    "code": 0,
    "req_id": "154274506",
    "rta_ids": ["51"]
}

附录

Os​

参数值含义
0未知
1ios
2安卓