平台通用 平台管理 网站应用 学习应用 Erp应用 商城应用 收付款应用

用户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 纬度

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

API测试工具