- Print
- PDF
CAPTCHA Overview
- Print
- PDF
We are preparing a localization service for the content. We will do our best to provide the localization service as soon as possible.
This service allows you to use NAVER’s image/audio CAPTCHA feature, which determines whether the user is human to prevent abuse. It is useful when you need to detect abusers with users’ simple input in cases where a user signs up or forget the password.
Common information
You can get a Client ID by registering your application in NAVER Cloud Platform Console.
Go to AI·Application Service > AI·NAVER API > Application in your web console and register an application. Learn how to register >
Check your Client ID and Client Secret by selecting the application registered in AI·Application Service > AI·NAVER API > Application.
Click [Edit] of the application to make sure that CAPTCHA (Image) or CAPTCHA (Audio) is selected. If it is not selected, a 429 error (Quota Exceed) occurs.
API URL
API name | Method | Request URL | Output format |
---|---|---|---|
CAPTCHA (Image) Get/compare keys | GET | https://naveropenapi.apigw.ntruss.com/captcha/v1/nkey | JSON |
CAPTCHA (Image) Request images | GET | https://naveropenapi.apigw.ntruss.com/captcha-bin/v1/ncaptcha | JPG |
CAPTCHA (Audio) Get/compare keys | GET | https://naveropenapi.apigw.ntruss.com/scaptcha/v1/skey | JSON |
CAPTCHA (Audio) Request files | GET | https://naveropenapi.apigw.ntruss.com/scaptcha-bin/v1/scaptcha | WAV file |
Request Header
Header | Description |
---|---|
X-NCP-APIGW-API-KEY-ID | Client ID issued when registering an appX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | Client Secret issued when registering an appX-NCP-APIGW-API-KEY:{Client Secret} |
Error Codes
Common errors
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | 100 | Bad Request Exception | Request error in protocol (https) or encoding (UTF-8). |
401 | 200 | Authentication Failed | Authentication failed. |
401 | 210 | Permission Denied | Authentication failed. |
404 | 300 | Not Found Exception | Authentication failed. |
429 | 400 | Quota Exceeded | Quota exceeded. |
429 | 410 | Throttle Limited | Rate exceeded. |
429 | 420 | Rate Limited | Rate exceeded. |
413 | 430 | Request Entity Too Large | Content-length exceeded (10 MB). |
503 | 500 | Endpoint Error | End point connection error |
504 | 510 | Endpoint Timeout | End point connection timeout |
500 | 900 | Unexpected Error | Unexpected error |
API errors
HTTP status code | Error code | Error message |
---|---|---|
400 | CT002 | Unissued image/wav (Audio or image not issued) |
403 | CT001 | Invalid key (Key expired or missing key) |
500 | CT500 | System error |