オンライン文章校正支援サービスPRUV（プルーフ）
使い方
ユーザー登録
ログインPRUV APIサービス
PRUVの校正機能を外部サイトに提供するAPIです。利用者側の開発が必要ですが、お使いのCMSやブログのエディタなどに組み込むことが可能です。
APIを使うには、管理画面で若干設定を行う必要があります。また設定できるのは組織管理者のみです。
「組織／グループ管理」でAPIサービスを「使用する」にします。
画面1 デフォルトは「使用しない」
この時点でAPIの呼び出しが可能です。
画面2 「使用する」にした画面
PRUVに送信するテキストをSSLで暗号化する場合は、「SSLキー（秘密鍵）」に適当な文字列（8～20文字）を入力してください。
なお、APIを利用するユーザーアカウントには二要素認証を設定しないでください。類推されにくいユーザーIDとパスワードを設定してご利用ください。上記のSSLキーを設定すれば、第三者による不正利用の可能性を低減できます（SSLキーが秘密である限り、APIが機能しないため）。
リクエストパラメータ
基本的にサイトの各種設定を利用するため、API呼び出し時のパラメータはシンプルです。
「Version」パラメータを指定すると各種オプションをAPIで制御可能になります。その代わり、全パラメータの有無、評価、設定のオーバーライド処理が発生するため速度は低下します。
| id | ： | ユーザーID（※必須） |
| pass | ： | パスワード（※必須） |
| usessl | ： | on／off |
| sentence | ： | 文章（※必須） |
| Version | ： | 以下のオプション指定に「V2」指定必須 |
| Kishuizon | ： | 機種依存文字チェック時「checked」 |
| Kanji | ： | 漢字チェック（1つを指定） 小学校学習漢字（1～6年）：l1、l2、l3、l4、l5、l6 常用漢字： joyo 漢字チェックなし： nokanji |
| Spell | ： | スペルチェック（1つを指定） 英語（米）：en_US イタリア語：it_IT スペイン語：es_ES ドイツ語：de_DE フランス語：fr スペルチェックなし：none |
| SpellCheckMin | ： | スペルチェックの最少文字数（整数値） |
| Yure | ： | 表記ゆれチェック時「checked」 |
| AI | ： | AIチェック（モデルを1つ指定）※一部の組織にのみ提供中 LSTM Transformer |
| DicSet | ： | PRUV提供の標準＆カスタム辞書（配列で指定） 例： ['要注意表現辞書', '不快語・差別語辞書', '単位辞書'] |
| UserDic | ： | ユーザー辞書使用時「on」 |
| GroupDic | ： | グループ辞書使用時「on」 |
| UseFrequency | ： | 頻出語チェック使用時「checked」 |
| FrequencyTarget | ： | 頻出語対象品詞。下記の形式（配列）で任意の品詞を指定 ['代名詞', '形式名詞', '名詞', '動詞', '補助動詞', '助動詞', '形容詞', '形容動詞語幹', '補助形容詞', '副詞', '連体詞', '接続詞', '感動詞'] |
| FrequencySpan | ： | 頻出語チェック対象範囲（整数値） |
| UseExtraSearch | ： | 外部サービス呼び出し機能使用時「checked」 |
| ExtraSearch | ： | 外部サービス。下記の形式（配列）で任意のサービスを指定 ['google', 'wikipedia', 'jpweblio', 'jpnifty', 'enggoo', 'engweblio', 'engejiro', 'engnifty', 'thesauweblio', 'thesaurenso', 'thesautamate'] google：Google wikipedia：Wikipedia jpweblio：Weblio国語辞典 jpnifty：@nifty辞書 enggoo：goo英和・和英辞書 engweblio：Weblio英和・和英辞書 engejiro：英辞郎 on the WEB engnifty：@nifty辞書（英和・和英辞典） thesauweblio：Weblio類語辞典 thesaurenso：連想類語辞典 thesautamate：類語玉手箱 |
管理画面で設定した「SSLキー（秘密鍵）」は送信しないことに注意してください。これらを「&」でつないでURLを構築します。以下は一例です。
?id=ユーザーID&pass=パスワード&usessl=off&sentence=今日は日曜日だ
以降で実際のAPI呼び出し方法の詳細を説明します。閲覧にはPRUV Businessのアカウントが必要です。PRUV Businessユーザーの方はログインしてください。
