GET/api/v1/captcha/challenge签发一个图形验证码挑战

Try it 面板需要启用 JavaScript。

返回挑战图片与不透明工单；答案由 captcha_service 私有保存，不随响应下发。

Request

Response

Body

Name	Data Type	Required	Description
captchaId	string	Yes	挑战 ID
image	string	Yes	挑战图片（base64 PNG）
ticket	string	Yes	挑战工单（校验时携带）
expiresAt	string	Yes	挑战过期时间

type ResponseBody = {
  /** 挑战 ID */
  captchaId: string
  /** 挑战图片（base64 PNG） */
  image: string
  /** 挑战工单（校验时携带） */
  ticket: string
  /** 挑战过期时间 */
  expiresAt: string
}

{
  "captchaId": "01JD8SJE0M4P8W3XN7R2VDH5T8A",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...",
  "ticket": "cpt_6f13bc82e0497a51",
  "expiresAt": "2026-10-14T08:10:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回挑战
429	频率受限	触发挑战签发频控

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回挑战

Examples

GET /api/v1/captcha/challenge

{
  "id": "01JD8SJFH2N9M3J4",
  "code": 0,
  "messages": [],
  "result": {
    "captchaId": "01JD8SJE0M4P8W3XN7R2VDH5T8A",
    "image": "iVBORw0KGgoAAAANSUhEUgAA...",
    "ticket": "cpt_6f13bc82e0497a51",
    "expiresAt": "2026-10-14T08:10:00Z"
  }
}