Skip to content

获取用户状态

接口说明

获取当前登录用户的完整状态信息,包括用户基本信息、亲密度、等级、关系状态、每日进度等。

请求信息

  • Method: GET
  • Path: /v1/users/me
  • 认证: 需要

响应示例

json
{
  "code": 0,
  "message": "success",
  "data": {
    "user": {
      "user_id": "95af8297-ae59-4802-bcce-b0e984195d48",
      "username": "testuser",
      "nickname": "小明"
    },
    "intimacy": {
      "score": 201,
      "next_level_score": 401,
      "progress_percent": 40.2,
      "last_interaction": "2025-10-06T10:30:00Z",
      "days_without_decay": 0
    },
    "level": {
      "level": 2,
      "name": "好朋友",
      "display_name": "好朋友",
      "description": "亲密好友,可以倾诉"
    },
    "relationship": {
      "status": "normal",
      "is_lover": false,
      "can_confess": false,
      "confess_success_rate": 0
    },
    "daily_status": {
      "morning_greeting_done": true,
      "chat_done": true,
      "night_greeting_done": false,
      "action_done": true,
      "actions_locked": false,
      "can_earn_points": 2,
      "max_daily_points": 8
    }
  }
}

响应字段说明

user

  • user_id: 用户唯一标识
  • username: 用户名
  • nickname: 昵称

intimacy

  • score: 当前亲密度分数
  • next_level_score: 下一等级所需分数
  • progress_percent: 当前等级进度百分比
  • last_interaction: 最后互动时间
  • days_without_decay: 未衰减天数

level

  • level: 等级数值
  • name: 等级名称
  • display_name: 显示名称(含恋人标识)
  • description: 等级描述

relationship

  • status: 关系状态(normal/lover)
  • is_lover: 是否为恋人
  • can_confess: 是否可以表白
  • confess_success_rate: 表白成功率

daily_status

  • morning_greeting_done: 是否已早安问候
  • chat_done: 是否已聊天
  • night_greeting_done: 是否已晚安问候
  • action_done: 是否已执行动作
  • actions_locked: 动作是否锁定
  • can_earn_points: 今日还可获得的点数
  • max_daily_points: 每日最大点数

错误情况

  • 401: 未认证

示例代码

bash
curl -X GET http://localhost:8081/v1/users/me \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
javascript
const response = await fetch('http://localhost:8081/v1/users/me', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const data = await response.json();
const userStatus = data.data;
console.log(`当前等级: ${userStatus.level.name}`);
console.log(`亲密度: ${userStatus.intimacy.score}`);
python
import requests

response = requests.get(
    'http://localhost:8081/v1/users/me',
    headers={
        'Authorization': f'Bearer {access_token}'
    }
)

data = response.json()
user_status = data['data']
print(f"当前等级: {user_status['level']['name']}")
print(f"亲密度: {user_status['intimacy']['score']}")

Released under the MIT License.