对接码管理
2. 获取对接码列表
更新于 2025-12-20:新增等级ID筛选、代理数量统计、字段别名兼容
接口地址: /merchantapi/distribution/bindcode/list
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 否 | 对接码(模糊搜索) |
| status | int | 否 | 状态:0=禁用,1=启用 |
| level_id | int | 否 | 代理等级ID筛选 |
| page | int | 否 | 页码 |
| limit | int | 否 | 每页数量 |
响应示例:
json
{
"code": 1,
"msg": "获取成功",
"data": {
"list": [
{
"id": 1,
"code": "DJM1234567890",
"bind_code": "DJM1234567890", // 兼容字段 ~~新增于 2025-12-20~~
"name": "金牌代理对接码",
"agent_level_id": 1,
"level_id": 1, // 兼容字段 ~~新增于 2025-12-20~~
"level_name": "金牌代理",
"status": 1,
"can_proxy": 1,
"allow_tier3": 1, // 兼容字段 ~~新增于 2025-12-20~~
"create_time": "2025-11-19 16:34:13",
"agent_count": 5 // 使用该对接码的代理数量 ~~新增于 2025-12-20~~
}
],
"total": 3
}
}3. 创建对接码
更新于 2025-12-20:每个等级最多可创建3个对接码(原为1个),支持字段别名
接口地址: /merchantapi/distribution/bindcode/create
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 对接码名称 |
| agent_level_id | int | 是 | 代理等级 ID(或使用 level_id) |
| level_id | int | 否 | 代理等级 ID(兼容字段) |
| can_proxy | int | 否 | 下级是否可代理:0=否,1=是(默认 0) |
| allow_tier3 | int | 否 | 下级是否可代理(兼容字段) |
响应示例:
json
{
"code": 1,
"msg": "创建成功"
}业务规则:
- 对接码自动生成,格式:DJM + 10 位随机字符
删除于 2025-12-20每个代理等级只能创建一个对接码新增于 2025-12-20每个代理等级最多可创建3个对接码- 对接码名称不能为空
4. 编辑对接码
更新于 2025-12-20:移除等级ID修改,支持字段别名
接口地址: /merchantapi/distribution/bindcode/edit
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 对接码 ID |
| name | string | 是 | 对接码名称 |
| can_proxy | int | 否 | 下级是否可代理 |
| allow_tier3 | int | 否 | 下级是否可代理(兼容字段) |
响应示例:
json
{
"code": 1,
"msg": "编辑成功"
}5. 删除对接码
接口地址: /merchantapi/distribution/bindcode/delete
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 对接码 ID |
响应示例:
json
{
"code": 1,
"msg": "删除成功"
}6. 修改对接码状态
接口地址: /merchantapi/distribution/bindcode/changestatus
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 对接码 ID |
| status | int | 是 | 状态:0=禁用,1=启用 |
| can_proxy | int | 否 | 下级是否可代理 |
响应示例:
json
{
"code": 1,
"msg": "编辑成功"
}7. 重置对接码
接口地址: /merchantapi/distribution/bindcode/resetBindCode
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 是 | 对接码 ID |
响应示例:
json
{
"code": 1,
"msg": "重置成功"
}说明: 重置后会生成新的对接码字符串