POST公开验证码图片PNG安全旧版vv1

短验证码图片(旧版)

迁移自旧 Face_Code:生成 1-4 位字符的图片验证码(PNG,带干扰线与噪点),data.code 是验证码的 md5。

/api/Face_Code
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

迁移自旧 Face_Code:生成 1-4 位字符的图片验证码(PNG,带干扰线与噪点),data.code 是验证码的 md5。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
msgstring验证码文本(1-4 位 ASCII,缺省随机 4 位)
typestring兼容旧返回格式参数,新平台统一返回图片
widthstring画布宽度 40-100,越界回落到 80(缺省 80)
heightstring画布高度 10-70,越界回落到 50(缺省 50)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{}

返回示例

response.json
{
  "code": 1,
  "data": {
    "code": "<md5>",
    "width": 80,
    "height": 50
  },
  "message": {
    "base64": "<base64>",
    "contentType": "image/png"
  }
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →