开始接入 Budyoo¶
接口和字段变更遵循维护与兼容规范;各接口页明确实现范围、校验规则和实际验证结果。
第一次接入¶
正式部署环境(上线前阶段)¶
Budyoo 当前只有这一套正式部署环境,没有独立的开发服、测试服或预发布服;所有开发与验收均按最终上线要求推进。文档中的 local/dev/prod 表示程序运行配置,隔离回归库表示测试数据隔离,均不代表另有一套服务器。
| 项目 | 地址或说明 |
|---|---|
| API 服务地址 | https://api.budyoo.cn |
| 请求格式 | JSON,语言使用 Accept-Language |
| 当前接口 | 系统、认证、注册、头像、VIP准入和后台首期已实现;新增本人/后台资料编辑和相册见各端目录及独立接口状态 |
| 传输加密 | API、后台和文档域名已完成公网HTTPS可达性检查;当前运行配置仍为dev,JSON遵循JWE协议 |
详细状态见加密与认证。文档使用https://docs.budyoo.cn/docs/,接口使用https://api.budyoo.cn;官网https://budyoo.cn/已完成公网访问验收。App业务尚处于上线前开发和验收阶段;正式部署环境这一称呼不表示已切换到prod配置或已完成全部客户端、供应商验收。
正式开放前计划清空当前数据库并按正式运行需要初始化;实施时明确清理范围,以及表结构、迁移版本、基础字典、管理员和业务配置的保留或重建方式,并处理旧会话及测试媒体引用。清库与关闭固定验证码等开发配置、真实供应商接入、正式配置验收分别完成,本次文档更正不执行清库。
需要了解的约定¶
登录注册页面对接见登录注册接入。新增14项认证、资料、字典及头像接口均独立维护;不能把代码测试通过视为真实短信或三方账号已经开通。
资料完成后还需按注册资料与VIP准入判断是否进入VIP页;开关动态配置,支付与权益由服务端确认,真实支付渠道尚未接通。
请求与响应说明统一字段、语言回退和错误码。文档维护规范说明如何按端、按模块维护独立接口文档。
AES 加密协议提供同路径 JSON 请求/响应加密与客户端封装;首先读取接口加密公钥。开发兼容、生产强制及传输限制均在协议中注明。
实时连接从建立长连接开始,说明首帧认证、心跳、重连和 Redis 事件路由边界;聊天业务尚未实现。
2026-11-20统一媒体协议已部署到唯一正式环境,运行配置仍为dev:后台选择CDN/OSS/API,App不再声明能力头,页面使用返回URL。服务器构建与实际验证范围见CDN验证记录;Flutter真机与完整业务体验仍需单独验收。