NGWord
This page is not available in English.
Please select another language.
概要
ゲーム上での投稿における運営ポリシーに反するテキストが含まれるかどうかを確認する為の API です。
![]() | アプリケーション内ニックネームにはTextDataAPIを適用しなくても構いませんが、NGWordAPIは必ず適用し、APIで不適切と判断された投稿はアプリ上に表示しないでください(ユーザに投稿されたニックネームの審査はNGWordAPIを利用するだけではなく、別途パートナー様による監視と対応が必要です) |
NGWord オブジェクトフィールド
値 | 説明 | 型 | 名前空間 | 補足 |
---|---|---|---|---|
data | テキストデータ | xs:string | http://ns.dena.jp/mbga/gameapi/v1 | – |
valid | NG ワードチェックに通っているかどうか | xs:boolean | http://ns.dena.jp/mbga/gameapi/v1 | – |
valid 値が true ならば問題無く投稿出来るテキストデータです。
API リクエスト
HTTP メソッド
Proxy モデル
- POST (オーバーロード POST)
- 入力テキストの検証
Trusted モデル
- POST (オーバーロード POST)
- 入力テキストの検証
オーバーロード POST とは RESTful API の統一インターフェース (GET, POST, PUT, DELETE) の操作から外れたメソッドに対するアクセスを明示する為に POST メソッドを用い、クエリパラメータ等でそのメソッドを明示することです。
本 API ではオーバーロード POST で実行するメソッドの指定に _method クエリパラメータを用います。
エンドポイント URL
Sandbox 環境
http://sb.app.mbga.jp/api/restful/v1/ngword
本番環境
http://app.mbga.jp/api/restful/v1/ngword
URI Template パラメータ
特にありません
クエリパラメータ
下記のクエリパラメータを指定する事が出来ます。
format
レスポンス形式を指定する事が出来ます。
値 | 説明 | 備考 |
---|---|---|
json | "application/json; charset=utf8" | 任意、デフォルト値 |
_method
オーバーロード POST によって実行するメソッド名を指定します。
値 | 説明 | 備考 |
---|---|---|
check | 送信されたデータに NG ワードが含まれるかどうかをチェックするメソッドです | 必須 |
API レスポンス
レスポンスコード
API のレスポンスコードは以下のいずれかになります。
リクエスト HTTP メソッド | レスポンスコード | レスポンスメッセージ | 説明 |
---|---|---|---|
GET | 200 | OK | 正常にデータの送信及び NG ワードの検証が完了しました。 |
GET | 400 | Bad Request | リクエストデータが不正です |
GET | 401 | Unauthorized | OAuth による認可が失敗しています |
GET | 500 | Internal Server Error | API 側の問題による失敗です |
注意事項
特にありません。
サンプル
NGWord の check
任意のテキスト文に NG ワードが含まれているかどうかを検証する例です。
リクエスト形式
POST /api/restful/v1/ngword?_method=check&format=json Content-Type: application/json; charset=utf8 { "data": "掲示板等で「殺す」などと言うと投稿が運営側によって削除される場合があります" }
レスポンス形式
200 OK { "totalResults": 1, "itemsPerPage" : 1, "ngword": { "valid": false }, "startIndex": 1 }
参考資料
XML Schema Part 2: Datatypes Second Edition
URI Template draft-gregorio-uritemplate-03
更新履歴
- 2013/03/15
- ドキュメント移行