CAPTCHAの概要

Prev Next

Classic/VPC環境で利用できます。

CAPTCHAは、人とコンピュータを判別して自動入力を防止する NAVERクラウドプラットフォームのサービスです。CAPTCHAサービスでは、人の目で識別できる文字を含む画像を転送して入力値を検証する CAPTCHA (Image)と、数字を含む音声メッセージを転送して入力値を検証する CAPTCHA (Audio) APIを RESTful形式で提供します。

CAPTCHAの共通設定

CAPTCHA APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

CAPTCHA (Image)キーの発行、入力値の照合: https://naveropenapi.apigw.ntruss.com/captcha/v1
CAPTCHA (Image)画像ファイルのリクエスト: https://naveropenapi.apigw.ntruss.com/captcha-bin/v1
CAPTCHA (Audio)キーの発行、入力値の照合: https://naveropenapi.apigw.ntruss.com/scaptcha/v1 
CAPTCHA (AUdio)音声ファイルのリクエスト: https://naveropenapi.apigw.ntruss.com/scaptcha-bin/v1

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-api-key-id Required NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client ID
x-ncp-apigw-api-key Required NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client Secret
参考

NAVERクラウドプラットフォームコンソールで Applicationを登録して APIの使用に必要な認証情報(Client ID、Client Secret)を発行する方法はの詳細は、CAPTCHAご利用ガイドをご参照ください。
コンソールで Applicationを登録した後に APIが選択されているか [変更] ボタンをクリックして確認してください。選択されていないと429(Quota Exceed)エラーが発生します。

レスポンス

共通レスポンス形式を説明します。

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

HTTPステータスコード コード メッセージ 説明
400 CT002 Unissued image or wav 画像または音声ファイルが発行されていない
403 CT001 Invalid Key 期限切れになっているか、存在しないキー
500 CT500 System Error 内部サーバエラー

CAPTCHA API

CAPTCHAサービスで提供する APIの説明は次の通りです。

API 説明
CAPTCHA (Image) > キーの発行 キャプチャ画像キーを発行
CAPTCHA (Image) > 画像ファイルのリクエスト キャプチャ画像ファイルをリクエスト
CATPCHA (Image) > 入力値の照合 キャプチャ画像とユーザー入力値を照合
CAPTCHA (Audio) > キーの発行 キャプチャオーディオキーを発行
CAPTCHA (Audio) > 画像ファイルのリクエスト キャプチャオーディオファイルをリクエスト
CATPCHA (Audio) > 入力値の照合 キャプチャオーディオとユーザー入力値を照合

CAPTCHA関連リソース

CAPTCHA APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。