本套API接口用于获取统计数据,不对数据进行任何增改操作。调用此套接口可以直接通过 http/https 发出请求和接受响应,从而获取统计对象的统计数据。 本套接口仅用于获取数据,若想调用 API 方式进行数据统计,请点击 [此处](https://www.kancloud.cn/aipaiteam/sinser/711070) 。 > 为了方便开发者获取统计数据,本套API无需申请数字签名,只需校验SecretKey 。 **通过本接口进行数据查询,每5分钟内第一次调用返回最新数据,后续将返回缓存数据。** *在线人数由于底层代码限制,在显示为1时不准确,实际为0或1。* * * * * * #### 参数信息 源地址:https://sinser.applinzi.com/api/api.php 请求方式:POST | 名称 | 是否可空 | 描述 | | --- | --- | --- | | SID | 不可空 |开发者创建统计对象后由系统分配的统计唯一标识。 | | Secretkey |不可空 | 开发者拥有的项目身份密钥。 | | en|可空 | 加密标识,详细说明见本文“安全性拓展”。 | > 所有**参数名称**都需要转为**小写**提交,参数值**不做处理**。 * * * * * ~~**建议所有开发者采用json方式返回数据,速度相对较快且处理方便**~~ **自10月1日更新后,返回的数据默认采取json格式,不可修改。** #### 请求示例: 具体示例: ~~~ https://sinser.applinzi.com/api/api.php > sid=<sid> > secretkey=<secretkey> > en=1 ~~~ **成功**:返回json格式汇总数据 > {"code":"1","today":"93","yesterday":"0","total":"164","month":"93","week":93,"today_ip":"2","yesterday_ip":"0","total_ip":"15","month_ip":"2","week_ip":2,"online":"23","name":"迅析接入教程","author":"爱派团队","updatetime":1538407434} 相关对应: | JSON键名 |解释 | | --- | --- | | code | 标识码,成功返回唯一标识码1 | | today | 当日软件使用次数 | | yesterday | 昨日软件使用次数 | | total | 软件使用总次数 | | week | 当周软件使用次数 | | month | 当月软件使用次数 | | today_ip | 当日IP数 | | yesterday_ip | 昨日IP数 | | total_ip | 总IP数 | | week_ip | 当周IP数 | | month_ip | 当月IP数 | | online |在线人数 | |name | 软件名称 | | author | 软件作者 | |updatetime|数据更新时间| > 注:json默认返回编码格式为UTF-8 相关编码请自行转换 **失败**:返回错误码以原因 ***** #### **安全性拓展** 调用数据查询接口时,允许对SID、Secretkey两项直接暴露在程序代码里的关键信息进行加密,以密文方式组合签名,分发至不受信任的客户端中使用。 SID加密算法为 Base654,示例: `XUNXI79340981KTrkHop -> WFVOWEk3OTM0MDk4MUtUcmtIb3A= (base64)` Secretkey加密算法为 sha1 ,示例: `mRxNXzFcVWwTdKrcJqBHhNVp -> 65d56ad91b42558c1d593362220c58b5c469a1f8 (sha1)` 若选择使用本安全性拓展,则SID、Secretkey均需加密处理,且需添加 POST请求参数:en=1,若不需要使用本安全拓展,请勿添加该参数。 > 为了保证数据安全,强烈建议所有开发者均使用此加密方式,否则容易造成SID、SecretKey等数据的泄露,从而造成数据损失。官方提供的所有SDK中,均采用此套加密方式。 * * * * * #### **举例说明** *本例子中使用安全性拓展中提到的信息加密方式请求接口,实际开发也建议开发者使用该信息加密方式。* 我们定义参数sid、secretkey的值分别为: **XUNXI79340981KTrkHop**、**mRxNXzFcVWwTdKrcJqBHhNVp** 对其进行 base64、sha1 加密: ~~~ XUNXI79340981KTrkHop -> WFVOWEk3OTM0MDk4MUtUcmtIb3A= mRxNXzFcVWwTdKrcJqBHhNVp -> 65d56ad91b42558c1d593362220c58b5c469a1f8 ~~~ 随后提交 ~~~ https://sinser.applinzi.com/api/api.php > sid=WFVOWEk3OTM0MDk4MUtUcmtIb3A= > secretkey=65d56ad91b42558c1d593362220c58b5c469a1f8 > en=1 ~~~