获取分组列表

应用场景

该接口可供第三方自动开区工具等,获取账户下已创建的所有分组。

接口链接

请求方式:只支持POST

URL地址:https://www.x7pay.net/api/grouplist.html

请求参数

字段名 变量名 必填 类型 示例值 描述
账户APIKEY apiKey String E0FB187A9A22D4F3CBCCEA58072A2DA7 小七充值平台分配给商户的apiKey,32位长度,是调用api的基本凭证

举例如下:

https://www.x7pay.net/api/grouplist.html?apiKey=E0FB187A9A22D4F3CBCCEA58072A2DA7

返回结果

字段名 变量名 必填 类型 示例值 描述
业务状态码 resultCode Int 200

200/201/500

此字段是业务标识状态码,200代表业务处理成功,并成功返回

业务状态描述 message String 成功

当resultCode非200时返回信息为错误原因 ,例如

apiKey不存在

数据集 Data String

当resultCode为200时,数据会装入该字段一并返回

分组列表信息 groupList String

该字段为分组列表的数据信息,在Data字段内,以JsonArray格式返回

groupList内的数据字段解释

字段名 变量名 必填 类型 示例值 描述
分组ID id Int 7777 该分组的唯一标识ID
分组名称 groupName String %E9%BB%98%E8%AE%A4%E5%88%86%E7%BB%84 该分组的名称,使用UrlDncode(UTF-8)解码,可参考编码/解码工具

举例如下:

{
    "resultCode": 200,
    "message": "成功",
    "Data": {
        "groupList": [
        {
            "groupName": "%E9%BB%98%E8%AE%A4%E5%88%86%E7%BB%84",
            "id": 3456
        },
        {
            "id": 2345,
            "groupName": "%E4%B8%BB%E6%92%ADA%E5%88%86%E7%BB%84"
        },
        {
            "groupName": "%E4%B8%BB%E6%92%ADB%E5%88%86%E7%BB%84",
            "id": 1234
        }
        ]
    }
}

状态码

状态码 描述
200 成功
201 业务错误,具体错误信息请参照message字段
500 系统错误

常用工具