API接口文档

第三方系统对接API接口，支持用户注册、登录及企业认证状态查询

接口列表

POST /api/auth/token

1. 获取访问令牌

使用AppId和AppSecret获取访问令牌（此接口无需认证）

请求参数

参数名 类型 必填 说明
app_id string 是 应用ID
app_secret string 是 应用密钥

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "access_token": "eyJhcHBfaWQiOiJ0ZXN0X2FwcF8wMDEiLCJpc3IiOiJHSi1BUEkiLCJleHAiOjE3Nzc3MjAwMDB9.abc123xxx",
    "expires_in": 7200,
    "token_type": "Bearer"
  },
  "timestamp": 1777710860
}
POST /api/users/register

2. 用户注册

请求头

Authorization: Bearer {access_token}
Content-Type: application/json

请求参数

参数名 类型 必填 说明
name string 是 用户名称
email string 是 邮箱
phone string 否 手机号
password string 是 密码（至少6位）
password_confirmation string 是 确认密码（需与password一致）
密码（已加密）

响应示例

{
  "code": 200,
  "message": "注册成功",
  "data": {
    "user_id": 123,
    "name": "testuser",
    "email": "test@example.com",
    "phone": "13800138000",
    "cert_status": "uncertified"
  },
  "timestamp": 1777710860
}
POST /api/users/login

3. 用户登录

请求头

Authorization: Bearer {access_token}
Content-Type: application/json

请求参数

参数名 类型 必填 说明
email string 是 邮箱
password string 是 密码（已加密）

响应示例

{
  "code": 200,
  "message": "登录成功",
  "data": {
    "user_id": 123,
    "name": "testuser",
    "email": "test@example.com",
    "cert_status": "approved",
    "user_token": "eyJ1c2VyX2lkIjoxMjMsInVzZXJuYW1lIjoidGVzdCJ9.abc123xxx"
  },
  "timestamp": 1777710860
}
GET /api/users/cert-status

4. 查询用户认证状态

请求头

Authorization: Bearer {access_token}

请求参数

参数名 类型 必填 说明
user_id int 是 用户ID

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "user_id": 123,
    "name": "testuser",
    "email": "test@example.com",
    "cert_status": "approved",
    "cert_status_desc": "已认证",
    "cert_time": "2026-05-03 15:00:00"
  },
  "timestamp": 1777710860
}

认证状态枚举：
uncertified 未认证
pending 审核中
approved 已认证
rejected 已拒绝

POST /api/users/cert-status/batch

5. 批量查询用户认证状态

请求头

Authorization: Bearer {access_token}
Content-Type: application/json

请求参数

参数名 类型 必填 说明
user_ids array[int] 是 用户ID数组（最多100个）

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 3,
    "users": [
      {
        "user_id": 123,
        "cert_status": "approved",
        "cert_status_desc": "已认证"
      },
      {
        "user_id": 124,
        "cert_status": "pending",
        "cert_status_desc": "审核中"
      },
      {
        "user_id": 125,
        "cert_status": "rejected",
        "cert_status_desc": "已拒绝"
      }
    ]
  },
  "timestamp": 1777710860
}