版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

signature(签名)生成方法:
1. 所有请求参数(不包括signature), 加入平台密钥secret=xxx, 根据参数名称进行字典递增排序(按照第一个字符的键值ASCII码递增排序, 如果遇到相同字符则按照第二个字符的键值ASCII码递增排序, 以此类推)
2. 将排序后的参数与其对应值, 组合成"参数=参数值"的形式, 然后用'&'字符连接起来, 作为待签名字符串(待签名字符串中可能包含中文, 请使用utf-8编码)
3. 将待签名字符串使用SHA1算法处理, 结果作为signature(签名)的值
secret只在待签名字符串中使用。请求接口时,请勿带上secret参数

Version information

Version : 1.0.0

URI scheme

Host : dataapi.tuzhanai.com
BasePath : /opendata
Schemes : HTTPS

Produces

  • application/json


Paths


统计量(非实时): 浏览量(pv),访客量(uv),微信分享量,表单量

GET /opendata/basicinfo/{fields}

Parameters

TypeNameDescriptionSchema
Pathfields 
required
pv: 浏览量
uv: 访客量
share: 微信分享量
form: 表单量
同时查询多项数据,使用英文逗号','分隔
< enum (pv, uv, share, form) > array(csv)
Queryopfid 
optional
开放平台idstring
Queryenterpriseid
required
企业id
企业id,在开发者中心里获取string
Queryappid 
required
作品idstring
Querycnl 
optional
渠道idstring
QuerystartTime 
optional
起始时间,格式yyyy-MM-dd HH:mm:ss,例如2018-01-01 00:00:00
返回大于等于此时间的数据
string
QueryendTime 
optional
终止时间,格式yyyy-MM-dd HH:mm:ss,例如2018-02-01 00:00:00
返回小于此时间的数据
string
Querynonce 
required
随机字符串,可取大小写字母和数字,至少6位string
Querytimestamp 
required
unix时间戳(毫秒)string
Querysignature 
required
签名字符串string

Responses

HTTP CodeDescriptionSchema
200正常响应object

Example HTTP request

Request path
/opendata/basicinfo/string?enterpriseid=string&appid=string&nonce=string&timestamp=string&signature=string

Example HTTP response

Response 200

...

{
  "status": 0, //status为200返回数据data,status为其他时返回错误消息errMsg
  "data": {
    "pv": "string",
    "uv": "string",
    "share": "string",
    "form": "string"
  },
  "errMsg": "string"
}


按时间分段统计量: 浏览量(pv),访客量(uv),微信分享量,表单量

GET /opendata/groupinfo/{fields}

Parameters

TypeNameDescriptionSchema
Pathfields 
required
pv: 浏览量,groupby=dt且无cnl参数返回实时数据
uv: 访客量,无实时数据
share: 微信分享量,groupby=dt且无cnl参数返回实时数据
form: 表单量,无实时数据
同时查询多项数据,使用英文逗号','分隔
< enum (pv, uv, share, form) > array(csv)
Queryopfid 
optional
开放平台idstring
Queryenterpriseid
required
企业idstring
Queryappid 
required
作品idstring
Querycnl 
optional
渠道idstring
QuerystartTime 
optional
起始时间,格式yyyy-MM-dd HH:mm:ss,例如2018-01-01 00:00:00
返回大于等于此时间的数据
string
QueryendTime 
optional
终止时间,格式yyyy-MM-dd HH:mm:ss,例如2018-02-01 00:00:00
返回小于此时间的数据
string
Querygroupby 
required
聚合方式
dt: 日期
dt,hr: 日期和小时
enum (dt, dt,hr)
Querynonce 
required
随机字符串,可取大小写字母和数字,至少6位string
Querytimestamp 
required
unix时间戳(毫秒)string
Querysignature 
required
签名字符串string

Responses

HTTP CodeDescriptionSchema
200正常响应object

Example HTTP request

Request path
/opendata/groupinfo/string?enterpriseid=string&appid=string&groupby=string&nonce=string&timestamp=string&signature=string

Example HTTP response

Response 200

...

{
  "status": 0, //status为200返回数据data,status为其他时返回错误消息errMsg
  "data": {
    "pv": [
      {
        "dt": "string",
        "hr": "string",
        "count": "string"
      }
    ],
    "uv": [
      {
        "dt": "string",
        "hr": "string",
        "count": "string"
      }
    ],
    "share": [
      {
        "dt": "string",
        "hr": "string",
        "count": "string"
      }
    ],
    "form": [
      {
        "dt": "string",
        "hr": "string",
        "count": "string"
      }
    ]
  },
  "errMsg": "string"
}


表单获取(实时)

GET /opendata/formInfos/fetch

Parameters

TypeNameDescriptionSchema
Queryopfid 
optional
开放平台idstring
Queryenterpriseid 
required
企业idstring
Queryappid 
required
作品idstring
Querychannelid 
optional
渠道idstring
QuerystartTime 
optional
起始时间,格式yyyy-MM-dd HH:mm:ss,例如2018-01-01 00:00:00
返回大于等于此时间的数据
string
QueryendTime 
optional
终止时间,格式yyyy-MM-dd HH:mm:ss,例如2018-02-01 00:00:00
返回小于此时间的数据
string
Querypage 
required
页码,从1开始integer
QuerypageSize 
required
每页条数,如果只关心返回的表单总条数(total)字段,可以传0integer
Querynonce 
required
随机字符串,可取大小写字母和数字,至少6位string
Querytimestamp 
required
unix时间戳(毫秒)string
Querysignature 
required
签名字符串string

Responses

HTTP CodeDescriptionSchema
200正常响应object

Example HTTP request

Request path
/opendata/formInfos/fetch?enterpriseid=string&appid=string&page=0&pageSize=0&nonce=string&timestamp=string&signature=string

Example HTTP response

Response 200
{

...


  "status": 0, //status为200返回数据data,status为其他时返回错误消息errMsg

...


  "data": {

...


    "pageNum": 0, //页码

...


    "pageSize": 0, //请求的每页条数

...


    "startRow": 0, //数据开始行数

...


    "endRow": 0, //数据结束行数

...


    "total": 0, //数据总条数

...


    "pages": 0, //数据总页数

...


    "result":

...

 [
      {
        "channelid": "string",

...


        "time": "string",

...


        "form": {} //表单详情

...


      }
    ]
  },
  "errMsg": "string"

...


}


按钮点击事件统计(非实时)

GET /opendata/pageInfo/curves/linkClickSum

Parameters

TypeNameDescriptionSchema
Queryopfid 
optional
开放平台idstring
Queryenterpriseid 
required
企业idstring
Queryappid 
required
作品idstring
Querychannelid 
optional
渠道idstring
QuerystartTime 
optional
起始时间,格式yyyy-MM-dd HH:mm:ss,例如2018-01-01 00:00:00
返回大于等于此时间的数据
string
QueryendTime 
optional
终止时间,格式yyyy-MM-dd HH:mm:ss,例如2018-02-01 00:00:00
返回小于此时间的数据
string
Querynonce 
required
随机字符串,可取大小写字母和数字,至少6位string
Querytimestamp 
required
unix时间戳(毫秒)string
Querysignature 
required
签名字符串string

Responses

HTTP CodeDescriptionSchema
200正常响应object

Example HTTP request

Request path
/opendata/pageInfo/curves/linkClickSum?enterpriseid=string&appid=string&nonce=string&timestamp=string&signature=string

Example HTTP response

Response 200

...

{
  "status": 0, //status为200返回数据data,status为其他时返回错误消息errMsg
  "data": {
    "linkClickSum": [
      {
        "btname": "string", //按钮名称或id
        "remark": "string", //按钮描述
        "count": 0
      }
    ]
  },
  "errMsg": "string"
}