# 试用功能

# 试用登录

# 请求地址

POST-http://api.paojiaoyun.com/v1/trial/login

# 请求参数

参数名	是否必需	类型	参数说明
app_key	是	string	软件的app_key
device_id	是	string	用户的设备唯一标识码
nonce	是	string	不超过36位的随机字符串（建议用UUID）详细解释
timestamp	是	int64	时间戳，秒级（10位数）
sign	是	string	签名
hg	int64	推荐本地心跳间隔（秒）注意很多语言默认sleep是毫秒，则需将该值乘以1000

# 响应示例

{
    "code": 0,
    "message": "ok",
    "result": {
        "expires": "2020-10-16 00:47:58",
        "expires_ts": 1602780478,
        "server_time": 1574654197,
        "hg": 600
    }
}

1
2
3
4
5
6
7
8
9
10

# 响应参数

参数名	类型	参数说明
code	int	返回码，0表示正确，详细参照返回码对照表
message	string	请求出错时的错误信息
result	object	请求正确时，若有额外数据要返回，则结果封装在该字段。若无额外数据，则无此字段。
expires	string	试用过期时间，格式化的
expires_ts	int64	过期时间戳，秒级（10位数）
server_time	int64	服务器当前时间戳，秒级（10位数）

# 试用心跳 💓

接口说明

用于保持登录状态，刷新 token 的有效期，token 在超过 30 分钟(该值可在软件配置页面更改)未收到心跳请求将自动失效。
建议每隔10分钟(也就是token有效期的三分之一)调用一次

# 请求地址

POST-http://api.paojiaoyun.com/v1/trial/heartbeat

# 请求参数

参数名	是否必需	类型	参数说明
app_key	是	string	软件的app_key
device_id	是	string	用户的设备唯一标识码
nonce	是	string	不超过36位的随机字符串（建议用UUID）详细解释
timestamp	是	int64	秒级时间戳，10位的
sign	是	string	签名

# 响应示例

{
    "code": 0,
    "message": "ok",
    "result": {
        "expires": "2020-10-16 00:47:58",
        "expires_ts": 1602780478,
        "server_time": 1574654207
    }
}

1
2
3
4
5
6
7
8
9

# 响应参数

参数名	类型	参数说明
code	int	返回码，0表示正确，详细参照返回码对照表
message	string	请求出错时的错误信息
result	object	请求正确时，若有额外数据要返回，则结果封装在该字段。若无额外数据，则无此字段。
expires	string	卡密过期时间，格式化的
expires_ts	int64	过期时间戳，秒级，10位的
server_time	int64	服务器当前时间戳，秒级，10位的

← 软件相关高级功能 →