• API密钥认证（需提供api_key参数）

• action - generateCustomer（必填）
• api_key - 您的API密钥（必填）
• project_id - 项目ID（必填）
• balance - 划转给客户的余额（必填）

POST /api.php
Content-Type: application/x-www-form-urlencoded

action=generateCustomer&api_key=YOUR_API_KEY&project_id=1&balance=100

{
  "status": "success",
  "message": "客户生成成功",
  "customer": {
    "id": 123,
    "username": "customerabc123def456",
    "api_key": "GENERATED_CUSTOMER_API_KEY",
    "project_id": 1,
    "project_name": "测试项目",
    "balance": 100.00,
    "customer_link": "http://example.com?key=GENERATED_CUSTOMER_API_KEY",
    "created_at": "2025-01-10 10:30:00"
  }
}

禁用指定客户账号，将其所有项目的余额自动退回到上级代理账户。客户账号被标记为禁用状态但记录保留，API密钥记录保留但余额归零。

• Cookie会话认证：已登录的管理员/代理用户，使用POST请求
• API密钥认证：提供api_key参数，使用GET请求

• 管理员：可删除任何客户
• 代理/子代理：只能删除自己创建的客户

• action - deleteCustomer（必填）
• customer_id - 要禁用的客户ID（必填，整数）
• api_key - API密钥（API密钥认证时必填）

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

重新启用已被禁用的客户账号，使其恢复正常使用。

• Cookie会话认证：已登录的管理员/代理用户，使用POST请求
• API密钥认证：提供api_key参数，使用GET请求

• 管理员：可启用任何客户
• 代理/子代理：只能启用自己创建的客户

• action - enableCustomer（必填）
• customer_id - 要启用的客户ID（必填，整数）
• api_key - API密钥（API密钥认证时必填）

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

{
  "status": "error",
  "message": "该客户已经是活跃状态"
}

为指定客户的指定项目增加或减少余额，所有操作都会记录到日志中。

• Cookie会话认证：已登录的管理员/代理用户
• API密钥认证：提供api_key参数

• 管理员：可调整任何客户余额
• 代理/子代理：只能调整自己创建的客户余额

• action - adjustCustomerBalance（必填）
• customer_id - 客户ID（必填，整数）
• project_id - 项目ID（必填，整数）
• amount - 调整金额（必填，浮点数，正数为增加，负数为减少）
• remark - 备注说明（可选）
• api_key - API密钥（API密钥认证时必填）

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

查询指定客户或所有客户的操作日志，包括创建、禁用、启用、余额调整等所有记录。

• Cookie会话认证：已登录的管理员/代理用户
• API密钥认证：提供api_key参数

• 管理员：可查看所有客户日志
• 代理/子代理：只能查看自己操作的日志

• action - getCustomerLogs（必填）
• customer_id - 客户ID（可选，不提供则返回所有日志）
• action_filter - 操作类型筛选（可选）：all（全部）、create（创建）、delete（禁用）、enable（启用）、balance_add（增加余额）、balance_subtract（减少余额）
• api_key - API密钥（API密钥认证时必填）

{
  "status": "success",
  "logs": [
    {
      "id": 1,
      "customer_id": 123,
      "action": "create",
      "action_text": "创建客户",
      "amount": "100.00",
      "customer_username": "customer123",
      "created_at": "2025-01-10 10:00:00",
      "operator_username": "admin",
      "operator_role": "admin",
      "project_name": "测试项目"
    },
    {
      "id": 2,
      "customer_id": 123,
      "action": "balance_add",
      "action_text": "增加余额",
      "amount": "50.00",
      "customer_username": "customer123",
      "created_at": "2025-01-10 11:00:00",
      "operator_username": "agent001",
      "operator_role": "agent",
      "project_name": "测试项目"
    }
  ],
  "filters": {
    "customer_id": 123,
    "action_filter": "all"
  }
}

• Session登录（网页端登录后调用）
• API密钥认证（需提供api_key参数）

• action - getUserApiKeys（必填）
• api_key - 您的API密钥（API密钥认证时必填）

GET /api.php?action=getUserApiKeys&api_key=YOUR_API_KEY

{
  "status": "success",
  "apiKeys": [
    {
      "id": 1,
      "api_key": "abc123def456...",
      "balance": 1000.50,
      "created_at": "2025-01-10 10:00:00",
      "project_id": 1,
      "project_name": "测试项目",
      "redirect_url": "https://example.com",
      "docs_url": "https://docs.example.com",
      "enable_recharge": 1
    }
  ]
}

API密钥认证：在请求中提供api_key参数即可调用接口。

适用接口：

• getUserApiKeys - 获取用户所有项目API密钥
• generateCustomer - 生成客户
• deleteCustomer - 禁用客户
• enableCustomer - 启用客户 NEW
• adjustCustomerBalance - 调整客户余额 NEW
• getCustomerLogs - 获取客户日志 NEW
• getMyCustomers - 获取我的客户列表