system/token
目录 |
1.接口说明
获取全局识别码
2.使用场景
在调用api之前首先要获取全局识别码(token)，然后才能通过 token 访问 api。两个小时内限制最多获取 token 2000 次，每个 token 的生命周期为 2 个小时（token 可重复使用，多个 api 可以使用同一个 token，请尽量保证声明周期内小频次调用，提升 api 调用质量）。
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/system/token |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2输入参数说明
| 参数 | 是否必填 | 描述 |
|---|---|---|
| from_account | 是 | 调用方id |
| app_key | 是 | 应用编码 |
| app_secret | 是 | 密钥 |
3.3请求示例
https://api.yonyouup.com/system/token?from_account=FromAccount&app_key=APPKEY&app_secret=APPSECRET
3.4返回参数说明
| 参数说明 | 描述 |
|---|---|
| errcode | 错误码，0 为正常。 |
| errmsg | 错误信息。 |
| id | 全局识别码。 |
| expiresIn | 过期时间（秒）。 |
3.5正确返回示例
JSON示例:
Content-type: text/html; charset=utf-8
{
"errcode":0,
"errmsg":"成功",
"token":{
"appKey":"opa9ef28dd7ccdad157",
"expiresIn":7200,
"id":"77397c50398f49aaa3513b71d34ec437"
}
}
3.6错误返回示例
Content-type: text/html; charset=utf-8
{
"errcode" : "2001",
"errmsg" : "用户名或密码错误"
}