---
title: "reCAPTCHA トークンを検証する"
method: POST
path: "/api/v1/auth/recaptcha"
tags: ["auth"]
---

# reCAPTCHA トークンを検証する

`POST /api/v1/auth/recaptcha`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/auth/recaptcha`
- Auth: HTTP bearer

## Request body

- object
  - `token` string, required
  - `action` string

## Response `200`

検証結果

- object
  - `success` boolean
  - `score` number

## Other responses

- `400`: リクエスト不正（code: validation_error）
- `403`: トークンが無効、または点数が閾値未満
- `429`: 回数の上限（接続元ごと・全体、1時間）。retry-after を待つ
- `503`: 検証できない（reCAPTCHA に繋がらない、または本番で鍵が未設定）

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)