---
title: "Verify Challenge Endpoint"
method: POST
path: "/api/v1/auth/verify-challenge"
tags: ["auth"]
---

# Verify Challenge Endpoint

`POST /api/v1/auth/verify-challenge`

## Request

- Base URL: `https://api.ticktest.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ticktest.cn/api/v1/auth/verify-challenge`
- Auth: none declared

验证滑块拼图位置。

校验 user_x 与 cutout_x 的差值是否在 tolerance 范围内。
通过后返回 verify_token（5分钟有效，一次性使用）。
失败需重新获取 challenge 重试。

## Request body

- VerifyChallengeRequest: 验证滑块位置请求
  - `challenge_id` string, required: 挑战 ID
  - `user_x` integer, required: 用户滑动的 X 坐标（px）
  - `user_y` integer: 用户滑动的 Y 坐标（px，可选）

## Response `200`

Successful Response

- VerifyChallengeResponse: 验证滑块位置响应
  - `status` string, required
  - `verify_token` string, nullable: 人机验证令牌（验证通过后返回，32位 hex）
  - `message` string, nullable: 错误信息（验证失败时返回）

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ticktest/apis/ticktest-api.md) · [All operations](https://skmtc.dev/ticktest/apis/ticktest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ticktest/apis/ticktest-api/revisions/3e6d69d0eb1e?raw)