接口文档

获取商户列表

更新时间：2018-04-12 15:21:09 更新人员：叶洋

文档状态：完成 #70 测试接口

章节导航器

接口基本信息
请求参数
响应数据参数
请求示例

摘要
获取商户列表

接口基本信息

接口名称：获取商户列表
请求方法：GET
接口地址：merch
登录验证：是

请求参数

参数名	参数	数据类型	是否必须	说明
page	分页数	int	否	获取指定页数的数据列表，不传递默认为1
row	每页数量	int	否
locked	锁定状态	int	否	数据筛选锁定状态1锁定0未锁定
type	连接类型	int	否	数据筛选商户类型3为开放连接类型商户
name	商户名称	string	否	模糊匹配商户名
contacts	商户联系人	string	否	模糊匹配联系人名
mobile	联系人手机	string	否	模糊匹配联系人手机
regist_time_s	注册时间起	string	否	匹配从何时起注册，需要和参数regist_time_e一起使用
regist_time_e	注册时间止	string	否	匹配注册时间，需要和参数regist_time_s一起使用
expiry_time_s	到期时间起	string	否	通过设置到期时间区间，匹配相关数据列表，需要和参数expiry_time_e一起使用
expiry_time_e	到期时间止	string	否	通过设置到期时间区间，匹配相关数据列表，需要和参数expiry_time_s一起使用

响应数据参数

参数名	参数	数据类型	说明
merch_id	商户id	string
code	商户代码	string
locked	锁定状态	string	商户是否已被锁定。1为已锁定，0为未锁定。
type	商户类型	int	1：开发模式，2：内部连接，3：开放连接
status	启用状态	int	状态，1为启用，0为禁用
regist_time	注册时间	string
expiry_time	有效期至	string
create_time	创建时间	string
update_time	更新时间	string
country_id	所在国	int
province_id	所在省	int
city_id	所在城市	int
district_id	所在地区	int
street_id	所在街道	int
address	详细地址	string
lng	经度	float
lat	纬度	float
merch_key	商户密钥	string
ip_whitelist	IP白名单	string
name	商户名	string
initials	首字母	string
english_name	英文名	string
contacts	联系人	string
mobile	手机号	string
email	邮箱	string
tel	座机	string
description	描述	string
remark	备注	string
status_text	状态描述	string
type_text	类型描述	string
locked_text	锁定描述	string

请求示例

请求例子：

 
apirq('merch')

返回数据结果：

 
{
    "code": 0,
    "msg": "ok",
    "time": "1523516220",
    "data": {
        "page": 1,
        "row": 15,
        "count": 5,
        "total_count": 5,
        "total_page": 1,
        "lists": [
            // ....
            {
                "merch_id": "c17ec996d3ff****",
                "code": "M01***",
                "locked": 1,
                "type": 2,
                "status": 1,
                "regist_time": "2017-12-01 00:00",
                "expiry_time": "2020-01-01 00:00",
                "create_time": "2017-12-04 11:17:40",
                "update_time": "2017-12-04 11:17:40",
                "country_id": 0,
                "province_id": 0,
                "city_id": 0,
                "district_id": 0,
                "street_id": 0,
                "lng": 0,
                "lat": 0,
                "merch_key": "********************************",
                "ip_whitelist": "",
                "name": "系统内部服务端",
                "initials": "",
                "english_name": "",
                "contacts": "开发员",
                "mobile": "13800000000",
                "email": "",
                "tel": "",
                "address": "成都一环路三段9号",
                "description": "",
                "remark": "",
                "status_text": "正常",
                "type_text": "开发模式",
                "locked_text": "已锁定"
            },
            // ....
        ]
    }
}