智能衣橱 App 与外部调用方公开接口契约。本契约是 App/外部公开接口唯一结构化源头,开发文档、静态展示站点与外部黑盒测试均应消费本 OpenAPI 文件;不包含 Manage 后台接口。
范围:只包含 App/外部调用接口;不包含 Manage 后台接口。后端业务错误统一通过 JSON body.code 表示。
验证码、第三方登录与登出
/api/v1/auth/login-by-code
/api/v1/auth/login/qq
/api/v1/auth/login/wechat
/api/v1/auth/logout
/api/v1/auth/send-code
当前用户资料、手机号绑定与风格偏好
/api/v1/user/bind-phone
/api/v1/user/change-phone/confirm
/api/v1/user/change-phone/send-code
/api/v1/user/change-phone/verify-old
/api/v1/user/me
/api/v1/user/preferences/style
家庭成员角色与成员手机号绑定
/api/v1/roles
/api/v1/roles/{roleId}
/api/v1/roles/{roleId}/bind-phone/confirm
/api/v1/roles/{roleId}/bind-phone/send-code
/api/v1/roles/member-bind-phone/send-code
角色虚拟形象集合
/api/v1/roles/{roleId}/avatars
/api/v1/roles/{roleId}/avatars/{avatarId}
/api/v1/roles/{roleId}/avatars/{avatarId}/default
衣物、图片、闲置、心愿单和转卖能力
/api/v1/roles/{roleId}/clothing
/api/v1/roles/{roleId}/clothing/{clothingId}
/api/v1/roles/{roleId}/clothing/{clothingId}/images
/api/v1/roles/{roleId}/clothing/{clothingId}/images/{imageId}
/api/v1/roles/{roleId}/clothing/{clothingId}/purchase
/api/v1/roles/{roleId}/clothing/{clothingId}/resale
/api/v1/roles/{roleId}/clothing/{clothingId}/sold
/api/v1/roles/{roleId}/clothing/{clothingId}/status
/api/v1/roles/{roleId}/clothing/{clothingId}/wishlist
/api/v1/roles/{roleId}/clothing/album-import
/api/v1/roles/{roleId}/clothing/batch-delete
/api/v1/roles/{roleId}/clothing/batch-move
/api/v1/roles/{roleId}/clothing/batch-update-location
/api/v1/roles/{roleId}/clothing/batch-update-status
/api/v1/roles/{roleId}/clothing/idle
/api/v1/roles/{roleId}/clothing/idle/stats
/api/v1/roles/{roleId}/clothing/reselling
/api/v1/roles/{roleId}/clothing/wishlist
收纳位置
/api/v1/roles/{roleId}/storage
/api/v1/roles/{roleId}/storage/{storageId}
/api/v1/roles/{roleId}/storage/{storageId}/clothing
穿搭方案
/api/v1/roles/{roleId}/outfits
/api/v1/roles/{roleId}/outfits/{outfitId}
穿搭计划
/api/v1/roles/{roleId}/plans
/api/v1/roles/{roleId}/plans/{planId}
穿搭记录
/api/v1/roles/{roleId}/wears
/api/v1/roles/{roleId}/wears/{wearId}
衣橱统计
/api/v1/roles/{roleId}/stats/category
/api/v1/roles/{roleId}/stats/overview
/api/v1/roles/{roleId}/stats/season
首页聚合与今日推荐
/api/v1/home
/api/v1/recommend/today
天气代理能力
/api/v1/weather/current
通知列表与已读状态
/api/v1/notifications
/api/v1/notifications/{notificationId}/read
/api/v1/notifications/read-all
用户反馈
/api/v1/feedback
/api/v1/feedback/{feedbackId}
登录设备
/api/v1/devices
/api/v1/devices/{deviceId}
上传凭证与服务端代传
/api/v1/upload/credentials
/api/v1/upload/file
/api/v1/upload/token
用户设置
/api/v1/settings
客户端关键埋点
/api/v1/client/events
衣物识别、语音、试穿与搭配推荐
/api/v1/ai/clothing-recognition
/api/v1/ai/clothing/filter-text
/api/v1/ai/outfit/recommend-voice
/api/v1/ai/outfit/recommend-weekly
/api/v1/ai/outfit/recommend
/api/v1/ai/try-on
/api/v1/ai/voice-recognition
版本检测
/api/v1/version
隐私设置
/api/v1/privacy
淘宝、闲鱼与购物辅助对外能力
/api/v1/shopping/analyze
/api/v1/shopping/entry
/api/v1/taobao/bind
/api/v1/taobao/import
/api/v1/taobao/orders
/api/v1/taobao/status
/api/v1/taobao/unbind
/api/v1/xianyu/bind
/api/v1/xianyu/publish
/api/v1/xianyu/status