1.总体
接口基于HTTP 1.X协议,以POST x-www-form-urlencoded方式提交;
接口有签名机制,有不同的环境:
正式:https://log.kajicam.com/log.cp
预发布:https://prelog.kajicam.com/log.cp
beta测试:http://betalog.kajicam.com/log.cp
日志调试说明:
查看beta日志:http://betalog.kajicam.com/logs/user.log
预发布环境日志查看:https://prelog.kajicam.com/logs/user.log
正式环境不提供
2.协议规范
以beta环境为例,有header参数和Body参数:
curl
// body参数
-d '``seq``=3&``d``={"appid":"test","ts": 1547606679,"duid": "0011E668A22944C593C2E0C4AF704EDB","bk": "-","os": "A","ver": "7.10.0","e": "chaopai.index.oninit","args": {"stkid": 398176}}'
// header参数
-H 't:1099e7db1f4fba65d5c8ff5f46b6bcd5426b6522' -X POST http://betalog.kajicam.com/log.cp
seq: 必选 类型int Client端发起的请求序号,从1开始,本次会话累计的请求数
d: 必选 类型String 详细的日志数据,JSON格式,定义和示例如下{"appid": "chaopai","ts": 1547606679,"duid": "0011E668A22944C593C2E0C4AF704EDB","bk": "-","os": "A","ver": "7.10.0","e": "chaopai.index.oninit","args": {"stkid": 398176}}
JSON格式:
appid ts duid bk os ver e args {k/v pairs}
appid 必选,应用名称,如潮拍h5的appid为chaopai
ts 必选,事件发生的客户端时间(时间戳格式1547606679,从1970开始的秒数)
duid 必选,咔叽device unique id(从app获取,如为空,则传递”-“)
bk 可选,咔叽bcookie(从app获取,如为空,则传”-“)
os 必选,操作系统(iOS传”I”,Android传”A”)
ver 必选,咔叽app 版本,如7.10.0(从app获取,如为空,则传”-“)
e 必选,event的缩写,事件名称,参照事件定义规范
cp_ver 可选,新增潮拍native内部版本,「20190514增加」
args 可选,各类kv键值的定义,比如内容id
请求Header参数
t 必选 类型String 签名value,规则sha1(seq+duid+种子),种子为chaopai
t=c0ec31d1ca1a3ae80d27f9a08c4c81f3f3bf1e04
返回:状态码为200即成功,返回ok字符串
辅助接口调试, 返回信息:
t = 1099e7db1f4fba65d5c8ff5f46b6bcd5426b6522
seq = 3
d = {“appid”:”test”,”ts”: 1547606679,”duid”: “0011E668A22944C593C2E0C4AF704EDB”,”bk”: “-“,”os”: “A”,”ver”: “7.10.0”,”e”: “chaopai.index.oninit”,”args”: {“stkid”: 398176}}
duid = 0011E668A22944C593C2E0C4AF704EDB
auth = 1099e7db1f4fba65d5c8ff5f46b6bcd5426b6522