迅析在调用统计接口时集成了用户上线指令,将用户与迅析服务器之间建立通讯以保持存活,系统默认的用户存活时间为 **5** 分钟。 > 即一个用户上线 5 分钟后,系统会自动与该用户断开通讯。尽管 5 分钟周期足够大部分程序使用,但是仍无法满足部分需求,因此我们单独增设了上线接口,通过循环调用本接口,以使开发者用于自身程序用户的长期在线。 本接口与统计接口的集成上线指令完全相同,存活周期为 5 分钟。 **本接口仅用于循环上线保持存活,若无需保持长期在线,请不要调用本接口!** * * * * * #### 参数信息 源地址:https://sinser.applinzi.com/api/online.php 请求方式:POST | 名称 | 是否可空 | 描述 | | --- | --- | --- | | SID | 不可空 |开发者创建统计对象后由系统分配的统计唯一标识 | | Authorization |不可空 | 数字签名,由签名算法生成 | > 所有**参数名称**都需要转为**小写**提交,参数值**不做处理**。 **请求示例** ~~~ https://sinser.applinzi.com/api/online.php > sid=<sid> > authorization=<authorization> ~~~ * * * * * #### **返回值** 返回UTF-8格式的json字符串,包含标识码(code)及相关提示(message)。 **举例说明** 成功: `{"code":"103"message":"TRUE!"}` 失败: `{"code":"<标识码>","message":<提示信息>}` 错误码具体对应原因请查询相关文档。