API 测试链路

本文件记录 docs/api-test-harness.html 内置的流程化链路。HTML 只直接执行 HTTP API；腾讯云 IM/TRTC SDK 动作作为客户端步骤列出，不伪造成后端接口。

01 三方注册/登录 -> 资料 -> 国家 -> token 生命周期

GET /healthz/ready：确认 gateway 可接流量。
GET /api/v1/countries：确认注册页国家主数据可读。
POST /api/v1/auth/third-party/login：使用真实 Firebase/Google ID token 登录或注册，写入 username/avatar/gender/birth/country/device/source 等注册字段。
GET /api/v1/users/me/identity：确认 user_id/display_user_id 映射。
GET /api/v1/users/me/overview：确认我的页聚合数据。
POST /api/v1/users/me/profile/update：修改用户名、头像、生日。
POST /api/v1/users/me/country/change：修改国家；同一用户一个月只允许一次，重复执行应返回冲突。
POST /api/v1/auth/password/set：首次设置密码。
POST /api/v1/auth/token/refresh：刷新 access token。
POST /api/v1/auth/logout：失效 refresh session。

POST /api/v1/rooms/create：创建房间，成功后回填 room_id。
POST /api/v1/rooms/join：加入业务 presence。
GET /api/v1/rooms/current：确认当前可恢复房间。
GET /api/v1/im/usersig：获取 IM sdk_app_id/user_id/user_sig。
客户端 IM SDK：TIM.create + login，房间群 ID 使用 room_id。
POST /api/v1/rtc/token：获取 RTC sdk_app_id/rtc_user_id/user_sig/str_room_id。
客户端 TRTC SDK：使用 str_room_id 进房。
POST /api/v1/rooms/mic/up：麦位进入 pending_publish，回填 mic_session_id/room_version。
客户端 TRTC SDK：switchRole(anchor) + startLocalAudio。
POST /api/v1/rooms/mic/publishing/confirm：带 mic_session_id/room_version/event_time_ms 确认发布。
GET /api/v1/rooms/snapshot：确认麦位进入 publishing。
POST /api/v1/rooms/heartbeat：刷新业务 presence。
POST /api/v1/rooms/mic/down：下麦。
POST /api/v1/rooms/leave：离房。