API マニュアル

利用方法

エンドポイント

https://app.cotogoto.ai/webapi/

利用回数

1日1000回までリクエストができます。

認証

登録時に発行されたConsumer Key(App Key)をリクエスト時に付与することで利用できます。

レスポンスコードとエラーコード

この API では HTTP レスポンスのステータスコードとレスポンスボディのJSON によって「成功」「失敗」を通知します。 この API が返すレスポンスコードとエラーコードを以下に示します。

レスポンス コード

意味

200

成功。

400

送信されたJSONの解析/変換に失敗した。

404

クラス/メソッドが見つからない。

500

その他の例外が発生した。

エラーコード

メッセージ

意味

10

parameter is required

パラメータが設定されていません。

20

Invalid or expired token

無効または有効期限が切れたConsumer Key(App Key)です。

21

Rate limit exceeded

このリクエストに対する制限は利用限度に達しています。

会話

URI

GET /noby.json

リクエスト

パラメータ

説明

初期値

設定

appkey

登録時に発行したConsumer Key(APIキー)を設定します。

-

必須

mail

コトゴトのログイン時のメールアドレスを設定します。 ※個人での利用する場合のみに限定してください。

-

任意

pass

コトゴトのログイン時のパスワートを設定します。 ※個人での利用する場合のみに限定してください。

-

任意

text

会話の文章を設定します。

-

必須

lat

緯度。コトゴトのチェックイン機能を利用します。

-

任意

lng

経度。コトゴトのチェックイン機能を利用します。

-

任意

study

会話時の学習の有無を選択します。 「0:無」,「1:有」

1

任意

persona

人工知能の人格を選択します。 「0:ノーマル」,「1:ツンデレ(女)」,「2:ツンデレ(男)」,「3:神」

0

任意

ending

語尾を設定します。 例:のじゃ、だっちゃ 等

-

任意

レスポンス

パラメータ親

パラメータ子

説明

commandId

-

コマンドIDを返します。

commandName

-

コマンド名を返します。

text

-

会話の返事を返します。

type

-

会話の返事タイプを返します。 (コマンド・あいさつ・係り受け・マルコフ連鎖・パターン・テンプレート・ランダム・あいづち等)

mood

-

会話のムードを返します。

negaposi

-

ネガポジ(ネガティブ -3 <---> 3 ポジティブ)を返します。

negaposiList

word

ネガポジの単語を返します。

score

ネガポジのスコア(ネガティブ -3 <---> 3 ポジティブ)を返します。

emotion

angerFear

感情のスコア(怖れ -3 <---> 3 怒り)を返します。

joySad

感情のスコア(悲しい -3 <---> 3 嬉しい)を返します。

likeDislike

感情のスコア(嫌い -3 <---> 3 好ましい)を返します。

emotionList

word

感情の単語を返します。

angerFear

感情のスコア(怖れ -3 <---> 3 怒り)を返します。

joySad

感情のスコア(悲しい -3 <---> 3 嬉しい)を返します。

likeDislike

感情のスコア(嫌い -3 <---> 3 好ましい)を返します。

wordList

feature

形態素の全情報を文字列で返します。

start

形態素の開始位置を返します。

surface

形態素の表記を返します。

art

-

固有表現(人工物名)を返します。

org

-

固有表現(組織名)を返します。

psn

-

固有表現(人名)を返します。

loc

-

固有表現(地名)を返します。

dat

-

固有表現(日付表現)を返します。

tim

-

固有表現(時刻表現)を返します。

AIとの会話のコツ

AIと会話する場合、キーワードが該当すると使える機能を以下で説明しています。