获取接口加密公钥¶
请求参数¶
无路径、查询或正文参数;可发送 Accept: application/json 和当前 App 的 Accept-Language。本接口分发公钥,不发送 X-Budyoo-Encryption。
生产环境只通过 HTTPS 取得公钥,不能跳过证书校验;开发 HTTP 例外只用于无敏感数据的加密协议测试。公钥可缓存60秒,重新获取公钥不会自动重放原业务请求。
请求示例¶
curl --fail-with-body \
-H 'Accept: application/json' -H 'Accept-Language: zh-CN' \
'https://api.budyoo.cn/api/v1/security/encryption-key'
成功响应¶
HTTP 200。JWK 中的 n、e、kid 是示意值,实际调用时读取服务器返回内容:
{
"code":"SUCCESS",
"message":"接口加密公钥已就绪。",
"data":{
"version":1,
"algorithm":"RSA-OAEP-256",
"encryption":"A256GCM",
"clockSkewSeconds":120,
"maxRequestBytes":262144,
"jwk":{
"kty":"RSA",
"use":"enc",
"alg":"RSA-OAEP-256",
"kid":"公钥SHA256指纹",
"n":"Base64URL公钥模数",
"e":"AQAB"
}
},
"errors":[]
}
kid 标识当前密钥,n/e 为 RSA 公钥参数,不含私钥 d/p/q。clockSkewSeconds 为请求时钟允许偏差,maxRequestBytes 为解密业务 JSON 上限。JWE 的 AES IV 固定12字节,认证标签16字节。
失败响应¶
生产明文 HTTP 返回426/HTTPS_REQUIRED。加密模块未启用时不会注册此入口;私钥配置缺失或非法会导致模块启动失败,不使用临时替代密钥。
接入说明¶
App 与管理网页共用此公钥分发契约。完整的每请求 AES 密钥、响应加密和错误处理见AES 加密协议。不把公钥来源的 HTTP 连接当作已经完成服务端身份认证。