1. 生成客户账号

接口名称：generateCustomerApi

功能说明：为指定项目创建客户账号，自动生成随机账号密码，并从上级余额划转到客户账号。

请求方式：GET

请求参数

返回示例

成功响应：

{
    "status": "success",
    "message": "客户生成成功",
    "customer": {
        "id": 123,
        "username": "customerabc1234567",
        "api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "project_id": 1,
        "project_name": "项目名称",
        "balance": 100.00,
        "customer_link": "https://example.com?key=xxxxxxxx",
        "created_at": "2026-04-10 12:00:00"
    }
}

失败响应：

{
    "status": "error",
    "message": "项目余额不足"
}

2. 禁用客户

接口名称：deleteCustomerApi

功能说明：禁用客户账号，剩余余额自动退回到上级代理。

请求方式：GET

请求参数

返回示例

{
    "status": "success",
    "message": "客户禁用成功",
    "refunded": 150.50,
    "refund_details": [
        {
            "project_id": 1,
            "amount": 150.50
        }
    ]
}

3. 调整客户余额

接口名称：adjustCustomerBalance

功能说明：为客户增加或减少指定项目的余额。

请求方式：POST

请求参数

返回示例

{
    "status": "success",
    "message": "余额调整成功",
    "amount": 50.00,
    "balance_before": 100.00,
    "balance_after": 150.00,
    "action": "增加"
}

4. 启用客户

接口名称：enableCustomer

功能说明：启用被禁用的客户账号。

请求方式：GET

请求参数

返回示例

{
    "status": "success",
    "message": "客户启用成功"
}

5. 查询客户余额

接口名称：getCustomerInfo

功能说明：通过客户管理API密钥查询指定客户的总余额及各项目余额明细，支持单个客户或批量查询多个客户。

请求方式：GET

请求参数

返回示例

成功响应（单个客户）：

{
    "status": "success",
    "customer": {
        "id": 123,
        "username": "customerabc1234567",
        "role": "user",
        "created_at": "2026-04-10 12:00:00",
        "balance": 168.50,
        "project_balances": [
            {
                "project_id": 1,
                "project_name": "项目A",
                "balance": 100.00
            },
            {
                "project_id": 2,
                "project_name": "项目B",
                "balance": 68.50
            }
        ]
    }
}

成功响应（批量查询）：

{
    "status": "success",
    "customers": [
        {
            "id": 123,
            "username": "customerabc1234567",
            "role": "user",
            "created_at": "2026-04-10 12:00:00",
            "balance": 168.50,
            "project_balances": [
                {
                    "project_id": 1,
                    "project_name": "项目A",
                    "balance": 100.00
                }
            ]
        },
        {
            "id": 456,
            "username": "customerxyz7654321",
            "role": "user",
            "created_at": "2026-04-11 09:30:00",
            "balance": 50.00,
            "project_balances": [
                {
                    "project_id": 3,
                    "project_name": "项目C",
                    "balance": 50.00
                }
            ]
        }
    ]
}

失败响应：

{
    "status": "error",
    "message": "请提供有效的客户ID（customer_id 或 customer_ids）"
}