verify_recaptcha (reCAPTCHA 검증)
Google reCAPTCHA v2 토큰을 검증합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/verify_recaptcha |
| Method |
POST |
| 인증 |
불필요 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| recaptcha_token |
string |
O |
프론트엔드에서 받은 reCAPTCHA 토큰 |
- |
요청 예시
{
"recaptcha_token": "03AGdBq24PBgdFKkK..."
}
응답
성공 (200)
{
"message": "검증 성공",
"success": true
}
실패 (403)
{
"message": "reCAPTCHA 검증 실패",
"success": false,
"error_codes": ["timeout-or-duplicate"]
}
error_codes 종류
| 코드 |
설명 |
missing-input-secret |
시크릿 키가 누락됨 |
invalid-input-secret |
시크릿 키가 유효하지 않음 |
missing-input-response |
토큰이 누락됨 |
invalid-input-response |
토큰이 유효하지 않음 |
bad-request |
잘못된 요청 |
timeout-or-duplicate |
토큰 만료 또는 이미 사용됨 |
오류 (500)
| 코드 |
message |
원인 |
| 500 |
"오류 발생: {에러}" |
서버 오류 |
참고
- reCAPTCHA v2 "I'm not a robot" 체크박스 토큰 검증용입니다.
- 토큰은 일회용이며, 검증 후 재사용할 수 없습니다.
- 토큰 유효시간은 약 2분입니다.
- 관련 API: [[registration]], [[registration_v2]]