巡护员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-for.reelmall.cn/v1/prperson/get

接口说明:

请求参数:
名称 类型 必须 示例值 描述
user_id Number true 用户id

响应参数:
名称 类型 示例值 描述
prperson PrPerson 巡护员

接口地址:http://api-for.reelmall.cn/v1/prperson/getlist

接口说明:

请求参数:
名称 类型 必须 示例值 描述
department_id Number true 部门id
q String false 姓名关键字查询
page_no Number false 第几页,默认1
page_size Number false 每页行数,默认20
child Boolean false false 是否查询子部门,默认否

响应参数:
名称 类型 示例值 描述
prpersons PrPerson[] 巡护员集合
total_results Number 总行数
total_pages Number 总页数