文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
获取商户列表
更新时间:2018-04-12 15:21:09   更新人员:叶洋   文档状态:完成 #70    测试接口
摘要
获取商户列表
  1. 接口基本信息
    接口名称:获取商户列表
    请求方法:GET
    接口地址:merch
    登录验证:是
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    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一起使用
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    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
  4. 请求示例
    请求例子:
     
    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": "已锁定"
                },
                // ....
            ]
        }
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员