跳到主要内容

获取图片验证码

POST 
/auth/v1/captcha/data

接口说明​

获取验证码图片RFC 2397标准的内联图片数据URI，响应参数的data字段为图片内容

使用步骤​

1. 获取验证码图片​
  • 前端调用该接口获取验证码数据
  • 将image_base64直接作为<img src>的值渲染
  • 在本地存储中保存返回的token（建议localStorage）
2. 提交验证码验证​

POST /api/v1/captcha/verify

3. 业务接口鉴权​

在需要验证码保护的业务请求中附加头部：

x-captcha-token: d8f7e2a5c6

Request​

Responses​

Response Headers
    Schema
      data 图片数据 (string)required

      RFC 2397标准的内联图片数据URI，包含以下部分：协议头：data: MIME类型：image/gif 编码方式：base64 实际数据：符合RFC 4648的Base64编码二进制数据

      type 类型 (string)required

      资源类型枚举值: "image" 图片类资源。其他值保留未来扩展

      token token (string)required

      验证码验证接口需要传入的token

      expires_in 过期时间 (integer)required

      令牌过期时间，默认300秒

    Loading...