本客服平台由提供产品服务

服务器端集成开发指南

诸葛君发表于:2015年11月10日 14:50:23更新于:2016年06月20日 11:33:48

对于无法在App客户端中布点的情况,您可以通过本文提供的接口,在应用服务器端或合适的位置时机上传用户及事件数据。

接口地址

https://apipool.zhugeio.com/open/v1/event_statis_srv/upload_event

请求方式

POST方式提交数据

调用验证

使用HTTP Basic Authentication方式做访问授权,HTTP Header里加一个字段(Key/Value对):

    Authorization: Basic base64_auth_string

其中 base64_auth_string 的生成算法为: base64(AppKey:SecretKey)。 即用AppKey加上冒号,加上SecretKey拼接起来,再做base64转换,AppKey和SecretKey在我的应用里面查看。

请求参数

自定义事件

    {
        "ts": "1437639572",                 // 上报时间(unixtime)(必填,单位是秒)
        "cuid": "hello@zhuge.io",           // 用户id(必填)
        "ak": "1234567890123456",           // AppKey(必填)
        "sdk": "web",                       // 平台信息: js为web android为and ios为ios (必填)
        "debug": 0,                         // 实时调试: 1为实时调试, 0或缺少此字段为正式数据
        "data": [
            {
                "et": "cus",                // 自定义事件, 固定为cus(必填)
                "eid": "share",             // 事件名称(必填)
                "ts": "1437639572",         // 事件时间(unixtime)(必填,单位是秒)
                "pr": {
                    "pr1": "xxxx"           // 事件属性
                }
            },
            {
                "et": "cus",                // 自定义事件, 固定为cus(必填)
                "eid": "click",             // 事件名称(必填)
                "ts": "1437639572",         // 事件时间(unixtime)(必填,单位是秒)
                "pr": {
                    "pr2": "xxxx"           // 事件属性
                }
            }
        ]
    }

用户信息

    {
        "ts": "1437639572",                 // 上报时间(unixtime)(必填,单位是秒)
        "cuid": "hello@zhuge.io",           // 用户id(必填)
        "ak": "1234567890123456",           // AppKey(必填)
        "sdk": "web",                       // 平台信息: js为web android为and ios为ios (必填)
        "data": [
            {
                "et": "idf",                // 用户信息, 固定为idf(必填)
                "cuid": "hello@zhuge.io",   // 用户id(必填)
                "ts": "1437639572",         // 事件时间(unixtime)(必填,单位是秒)
                "pr": {
                    "mobile": "18710002233",// 用户信息
                    "name": "hello"
                }
            }
        ]
    }

返回参数

示例

请求

    curl --insecure -X POST "https://apipool.zhugeio.com/open/v1/event_statis_srv/upload_event" 
    -u "AppKey:SecretKey" -d 'data=ewogICAgInRzIjogIjE0Mzc2Mzk1NzIiLAog
    ICAgImN1aWQiOiAiaGVsbG9Aemh1Z2UuaW8iLAogICAgImFrIjogIjEyMzQ1Njc4OTAxMjM0NTYiLAogIC
    AgInNkayI6ICJhbmQiLAogICAgImRhdGEiOiBbCiAgICAgICAgewogICAgICAgICAgICAiZXQiOiAiY3Vz
    IiwKICAgICAgICAgICAgImVpZCI6ICJzaGFyZSIsCiAgICAgICAgICAgICJ0cyI6ICIxNDM3NjM5NTcyIi
    wKICAgICAgICAgICAgInByIjogewogICAgICAgICAgICAgICAgInByMSI6ICJ4eHh4IgogICAgICAgICAg
    ICB9CiAgICAgICAgfSwKICAgICAgICB7CiAgICAgICAgICAgICJldCI6ICJjdXMiLAogICAgICAgICAgIC
    AiZWlkIjogImNsaWNrIiwKICAgICAgICAgICAgInRzIjogIjE0Mzc2Mzk1NzIiLAogICAgICAgICAgICAi
cHIiOiB7CiAgICAgICAgICAgICAgICAicHIyIjogInh4eHgiCiAgICAgICAgICAgIH0KICAgICAgICB9CiAgICBdCn0='

成功返回

    {
        "data": null,
        "return_code": 0,
        "return_message": ""
    }

错误返回

    {
        "data": null,
        "return_code": -10005003,
        "return_message": "系统忙"
    }
    您需要登录后才可以回复