平台通用 平台管理 网站应用 学习应用 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/lylmchnt/add需要授权信息

接口说明：

请求参数：
名称 类型 必须 示例值 描述
name String true 名称
register_no String true 统一信用代码
sp_business String false 营业范围，多个可使用半角逗号隔开
phone String false 联系电话
intro String false 简介

响应参数：
名称 类型 示例值 描述
mchnt_id Number 新增成功，返回机构id值(等于0，说明新增失败)

接口地址：http://api.reelmall.cn/v1/lylmchnt/update

接口说明：

请求参数：
名称 类型 必须 示例值 描述
mchnt_id Number true 机构id
name String false 名称
register_no String false 统一信用代码
sp_business String false 营业范围，多个可使用半角逗号隔开
phone String false 联系电话
intro String false 简介

响应参数：
名称 类型 示例值 描述
is_success Boolean 是否成功

接口地址：http://api.reelmall.cn/v1/lylmchnt/getlist

接口说明：

请求参数：
名称 类型 必须 示例值 描述
q String false 模糊查询值(名称)
page_size Number false 每页行数，默认20
page_no String false 第几页,默认1

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

接口地址：http://api.reelmall.cn/v1/lylmchnt/get

接口说明：

请求参数：
名称 类型 必须 示例值 描述
mchnt_id Number true 机构id

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

API测试工具