GET/api/v1/security/encryption-key
匿名公钥查询JSON 响应接入指南 ↗

获取接口加密公钥

请求参数

无路径、查询或正文参数;可发送 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 连接当作已经完成服务端身份认证。