↗

App 接口

iOS · Android
按功能查看接口与调用示例

查看接口目录 →
↗

管理后台接口

运营管理网页
接口权限与后台业务约定

查看接口目录 →

开始接入 Budyoo

接口和字段变更遵循维护与兼容规范;各接口页明确实现范围、校验规则和实际验证结果。

第一次接入

  1. 阅读快速接入,配置服务地址与公共请求头。
  2. 调用获取系统信息,确认网络连接和语言选择。
  3. 按公共请求头传递版本、渠道和设备标识,调用标准请求测试核对完整结果。
  4. 使用统一请求封装处理响应、错误与超时。

正式部署环境(上线前阶段)

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真机与完整业务体验仍需单独验收。