登录
go/1/login
URL
http://api.youkong.com/go/1/login
支持格式
JSON
http 请求方式
POST
加密方式
C/S 采用相同的加密算法
请求参数
参数 |
必选 |
类型 |
说明 |
name |
True |
string |
用户名,每个用户的用户名都是唯一的,长度:2~16 |
password |
True |
string |
密码,密码应该足够复杂,长度:6~24 |
返回结果
json 示例
{
"status":1,
"result":{
"token":"214654165456415uijdfkjojiogjewopjop.jojiojfejo",
"name":"redback",
"slogan":"我喜欢喝咖啡,你喜欢喝酒。我喜欢散步,你讨厌运动。我喜欢听古典音乐,你爱听流行曲。我喜欢吃肉,你喜欢吃菜。我喜欢购物,你讨厌逛街。我不相信婚姻,你渴望结婚。我喜欢冒险,你渴望安定的生活。我们追寻的东西越来越不一样。原来,我们并不相似。为什么我们曾经觉得彼此如此相像",
"gender":"男",
"location":"广东省-广州市-天河区",
“birthday":"1994-03-15",
"height":176,
"weight":65,
"totalFrequency":13,
"totalTime":31526,
"totalDistance":102.74,
"totalCalories":23546.56
}
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
token |
string |
用户认证的 Token |
name |
string |
更改用户名,每个用户名是唯一的 |
slogan |
string |
与自己或运动相关的一句话或一段文字,长度:3~140 |
gender |
string |
性别:男、女、其他 三个选项 |
location |
string |
长期所在地 |
birthday |
string |
生日,格式: YYYY-mm-dd |
height |
int |
身高,单位:cm |
weight |
int |
体重,单位:kg |
totalFrequency |
int |
总运动次数 |
totalTime |
int |
总运动时间,单位:s |
totalDistance |
float |
总运动距离,单位:km |
totalCalories |
float |
总热量消耗,单位:Kcal |
注册
go/1/register
URL
http://api.youkong.com/go/1/register
支持格式
JSON
http 请求方式
POST
加密方式
C/S 采用相同的加密算法
请求参数
参数 |
必选 |
类型 |
说明 |
name |
True |
string |
用户名,每个用户的用户名都是唯一的,长度:2~16 |
email |
True |
E-Mail |
电子邮箱,用来找回密码或用户认证等 |
password |
True |
string |
密码,密码应该足够复杂,长度:6~24 |
返回结果
json 示例
{
"status":1,
"result":"214654165456415uijdfkjojiogjewopjop.jojiojfejo"
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
string |
返回结果,此处为 Token |
创建个人信息
go/1/profile
URL
http://api.youkong.com/go/1/profile
支持格式
multipart/form-data
http 请求方式
POST
是否需要登录
是
认证方式
HTTP Token Authentication
加密方式
C/S 采用相同的加密算法对发送的所有内容加密
请求参数
参数 |
必选 |
类型 |
说明 |
name |
True |
string |
更改用户名,每个用户名是唯一的 |
slogan |
True |
string |
与自己或运动相关的一句话或一段文字,长度:3~140 |
gender |
True |
string |
性别:男、女、其他 三个选项 |
location |
True |
string |
长期所在地 |
birthday |
True |
string |
生日,格式: YYYY-mm-dd |
height |
True |
int |
身高,单位:cm |
weight |
True |
int |
体重,单位:kg |
返回结果
json 示例
{
"status":1,
"result":{
"name":"redback",
"slogan":"人生的乐趣不是很多,但相信自己绝对是其中一个...",
"gender":"男",
"location":"广东省-广州市-天河区",
“birthday":"1994-03-15",
"height":176,
"weight":65
}
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
name |
string |
更改用户名,每个用户名是唯一的 |
slogan |
string |
与自己或运动相关的一句话或一段文字,长度:3~140 |
gender |
string |
性别:男、女、其他 三个选项 |
location |
string |
长期所在地 |
birthday |
string |
生日,格式: YYYY-mm-dd |
height |
int |
身高,单位:cm |
weight |
int |
体重,单位:kg |
更新个人信息
go/1/profile
URL
http://api.youkong.com/go/1/profile
支持格式
multipart/form-data
http 请求方式
PATCH
是否需要登录
是
认证方式
HTTP Token Authentication
加密方式
C/S 采用相同的加密算法对发送的所有内容加密
请求参数
参数 |
必选 |
类型 |
说明 |
name |
False |
string |
更改用户名,每个用户名是唯一的 |
slogan |
False |
string |
与自己或运动相关的一句话或一段文字,长度:3~140 |
gender |
False |
string |
性别:男、女、其他 三个选项 |
location |
False |
string |
长期所在地 |
birthday |
False |
string |
生日,格式: YYYY-mm-dd |
height |
False |
int |
身高,单位:cm |
weight |
False |
int |
体重,单位:kg |
返回结果
json 示例
{
"status":1,
"result":{
"name":"Tom",
"美是这个世界上最无用的东西,可若是没有了美,所有人就只能在日复一日里活活捱下去。"
"gender":"男",
"location":"湖南省-郴州市-资兴市",
“birthday":"1996-07-26",
"height":181,
"weight":76
}
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
name |
string |
更改用户名,每个用户名是唯一的 |
slogan |
string |
与自己或运动相关的一句话或一段文字,长度:3~140 |
gender |
string |
性别:男、女、其他 三个选项 |
location |
string |
长期所在地 |
birthday |
string |
生日,格式: YYYY-mm-dd |
height |
int |
身高,单位:cm |
weight |
int |
体重,单位:kg |
插入一条运动记录
go/1/record
URL
http://api.youkong.com/go/1/record
支持格式
multipart/form-data
http 请求方式
POST
是否需要登录
是
认证方式
HTTP Token Authentication
加密方式
C/S 采用相同的加密算法对发送的所有内容加密
请求参数
参数 |
必选 |
类型 |
说明 |
image |
True |
binary |
图片,记录运动过程中的一张图片;格式: png、jpg、jpeg |
paths |
True |
binary |
记录运动轨迹点集合的文件;格式:Go_path_times.go |
mark |
True |
binary |
起始和每公里标记点; 格式:Go_mark_times.go |
speeds |
True |
binary |
每公里配速,单位:s; 格式:Go_speeds_times.go |
distance |
True |
float |
运动距离,单位:m |
date |
True |
string |
运动开始时间,格式:YYYY-mm-dd HH-MM-SS |
times |
True |
int |
运动次数 |
type |
True |
int |
运动类型,1:跑步,2:走路,3.... |
time |
True |
int |
运动用时,单位:s |
city |
True |
string |
运动城市,地名仅限中国境内 |
calories |
True |
string |
运动消耗热量,单位:Kcal |
reportTime |
True |
string |
天气发布时间 |
temperature |
True |
string |
温度 |
weatherResult |
True |
string |
天气状况 |
windDirection |
True |
string |
风向 |
windPower |
True |
string |
风力 |
humidity |
True |
string |
湿度 |
返回结果
json 示例
{
"status":1,
"result":description
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
description |
string |
对返回结果说明的若干文字 |
获取单条运动记录
go/1/record/times
URL
http://api.youkong.com/go/1/record/times
http 请求方式
GET
是否需要登录
是
认证方式
HTTP Token Authentication
加密方式
C/S 采用相同的加密算法对发送的所有内容加密
请求参数
参数 |
类型 |
说明 |
times |
int |
根据运动次数获取相应的记录 |
返回结果
json 示例
{
"status":1,
"result":{
”iamge":"/go/file/fileName",
"paths":"/go/file/fileName",
"mark":"/go/file/fileName",
"speeds":/go/file/fileName“,
"distance":10050.20,
"date":"2016-09-13 20:33:24",
"times":9,
"type":1,
"time":3700,
"mind":"人生的乐趣不是很多,但相信自己绝对是其中一个...",
"speeds":3.6,
"city":"广州市",
"calories":2135.56,
"reportTime":"2016-09-13 18:00",
"temperature":"33",
"weatherResult":"晴",
"windDirection":"东南",
"windPower":"4",
"humidity":"58"
}
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
image |
binary |
图片,记录运动过程中的一张图片;格式: png、jpg、jpeg |
paths |
binary |
记录运动轨迹点集合的文件;格式:Go_path_times.go |
mark |
binary |
起始和每公里标记点; 格式:Go_mark_times.go |
speeds |
binary |
每公里配速,单位:s; 格式:Go_speeds_times.go |
distance |
float |
运动距离,单位:m |
date |
string |
运动开始时间,格式:YYYY-mm-dd HH-MM-SS |
times |
int |
运动次数 |
type |
int |
运动类型,1:跑步,2:走路,3.... |
time |
int |
运动用时,单位:s |
city |
string |
运动城市,地名仅限中国境内 |
calories |
string |
运动消耗热量,单位:Kcal |
reportTime |
string |
天气发布时间 |
temperature |
string |
温度 |
weatherResult |
string |
天气状况 |
windDirection |
string |
风向 |
windPower |
string |
风力 |
humidity |
string |
湿度 |
获取所有运动记录
go/1/record
URL
http://api.youkong.com/go/1/record
http 请求方式
GET
是否需要登录
是
认证方式
HTTP Token Authentication
加密方式
C/S 采用相同的加密算法对发送的所有内容加密
请求参数
无
返回结果
json 示例
{
"status":1,
"result":[{
”iamge":"/go/file/fileName",
"paths":"/go/file/fileName",
"mark":"/go/file/fileName",
"speeds":/go/file/fileName“,
"distance":10050.20,
"date":"2016-09-18 19:43:21",
"times":9,
"type":1,
"time":3700,
"mind":"何时是你的世界,黑夜结束,白天的开始?我们的世界总是由我们的内心所呈现,所以,如果我们的内心没有光明呈现,无论我们处在何时,那将都是处于黑夜之中。",
"speeds":3.6,
"city":"广州市",
"calories":2135.56,
"reportTime":"2016-09-13 18:00",
"temperature":"33",
"weatherResult":"晴",
"windDirection":"东南",
"windPower":"4",
"humidity":"58"
},{
”iamge":"/go/file/fileName",
"paths":"/go/file/fileName",
"mark":"/go/file/fileName",
"speeds":/go/file/fileName“,
"distance":12050.20,
"date":"2016-09-16 20:33:24",
"times":8,
"type":1,
"time":3860,
"mind":"黑夜若能读懂我的思念 当残红的夕阳被夜色吞噬, 那点点的星辰和朦胧的月色,就独霸了夜空。岁月就在这日落月升,花开花谢中悄然流逝。因此,我总想向岁月讨要些什么,来结束我平淡的生活。",
"speeds":3.6,
"city":"广州市",
"calories":2375.56,
"reportTime":"2016-09-16 18:00",
"temperature":"33",
"weatherResult":"多云",
"windDirection":"南",
"windPower":"3",
"humidity":"49"
},...]
}
字段说明
返回值字段 |
字段类型 |
字段说明 |
status |
int |
状态码,1:成功,0:失败 |
result |
* |
返回结果,可以是一个任何类型的值,数组,或对象 |
image |
binary |
图片,记录运动过程中的一张图片;格式: png、jpg、jpeg |
paths |
binary |
记录运动轨迹点集合的文件;格式:Go_path_times.go |
mark |
binary |
起始和每公里标记点; 格式:Go_mark_times.go |
speeds |
binary |
每公里配速,单位:s; 格式:Go_speeds_times.go |
distance |
float |
运动距离,单位:m |
date |
string |
运动开始时间,格式:YYYY-mm-dd HH-MM-SS |
times |
int |
运动次数 |
type |
int |
运动类型,1:跑步,2:走路,3.... |
time |
int |
运动用时,单位:s |
city |
string |
运动城市,地名仅限中国境内 |
calories |
string |
运动消耗热量,单位:Kcal |
reportTime |
string |
天气发布时间 |
temperature |
string |
温度 |
weatherResult |
string |
天气状况 |
windDirection |
string |
风向 |
windPower |
string |
风力 |
humidity |
string |
湿度 |
文件下载
go/1/file/fileName
URL
http://api.youkong.com/go/1/file/fileName
http 请求方式
GET
加密方式
C/S 采用相同的加密算法
请求参数
参数 |
必选 |
类型 |
说明 |
fileName |
True |
string |
需要下载的文件名 |
返回结果
Binary/Stream