用户API

  • 请求方法为 POST。
  • 数据提交方式 application/json。
  • 支持https调用。
  • 支持微信/支付宝小程序、App、Web端等调用。
请求参数
名称 类型 是否必须 描述
app_key String TOP分配给应用的AppKey。
session String 用户登录授权成功后,TOP颁发给当前用户的授权信息,API提示需要授权信息时,必传。
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。API服务端允许客户端请求最大时间误差为前后各3分钟。
sign String API输入参数签名结果(仅支持md5加密)
  • 对所有API请求参数(包括公共参数和业务参数,但除去sign参数、非必填项值为空的参数、byte[]类型的参数,byte[]使用base64编码后,也无需加入签名),根据参数名称的ASCII码表的顺序排序。如:foo:1, bar:2, foo_bar:3, foobar:4排序后的顺序是bar:2, foo:1, foo_bar:3, foobar:4。
  • 将排序好的参数名和参数值拼装在一起,根据上面的示例得到的结果为:bar2foo1foo_bar3foobar4
  • 把拼装好的字符串采用utf-8编码,使用签名算法对编码后的字节流进行摘要。如果使用MD5算法,则需要在拼装的字符串前加上app的secret后,再进行摘要,如:md5(secret+bar2foo1foo_bar3foobar4)。
响应参数
名称 类型 描述
is_error Boolen 是否出错
error_code String 错误码
error_msg String 错误信息
msg String 业务信息

接口地址:http://api.reelmall.cn/v1/user/login

接口说明:

请求参数:
名称 类型 必须 示例值 描述
username String true 用户名
password String true md5哈希值后大写

响应参数:
名称 类型 示例值 描述
organ_id Number 所属机构id
department_id Number 所属部门id
user_id Number 用户id
user_type Number 用户类型
nick String 昵称/名称
avatar_url String 头像url
session String 授权信息key

接口地址:http://api.reelmall.cn/v1/user/getsession

接口说明:

请求参数:
名称 类型 必须 示例值 描述
authcode String true 授权码

响应参数:
名称 类型 示例值 描述
user_id Number 用户id

接口地址:http://api.reelmall.cn/v1/user/uploadfile需要授权信息

接口说明:

请求参数:
名称 类型 必须 示例值 描述
filename String true my.jpg 文件名
filecontent Byte[] true 文件内容,base64编码

响应参数:
名称 类型 示例值 描述
asset_id Number 资源id
asset_url String 资源url

接口地址:http://api.reelmall.cn/v1/user/uplocation需要授权信息

接口说明:

请求参数:
名称 类型 必须 示例值 描述
loc_time DateTime true 2000-01-01 00:00:00 记录时间,格式:yyyy-MM-dd HH:mm:ss
coord_type_input String true wgs84:GPS ,gcj02:国测局加密,bd09ll:百度
longitude String true 经度
latitude String true 纬度

响应参数:
名称 类型 示例值 描述