API仕様|Neurox チャットボット

version 1.03

API一覧

API No. API名 機能概要
QA-001 Q&A 登録 API Q&A、盛Q(※)の登録や更新を行うAPI
QA-002 Q&A 検索 API queryテキストから、近いQuestionを検索し、上位5件を返却するAPI
QA-003 Q&A 削除 API 特定IDのQ&Aを削除するAPI
QA-004 全Q&A 取得 API 登録済みのQ&Aを全て取得するAPI
QA-005 盛Q(※) 削除 API 特定IDのQ&Aの盛Qを全て削除するAPI
QA-006 コミット API Q&Aの登録後やシノニム登録後、学習を行うためのAPI
SY-001 同義語 登録 API 同義語の登録や更新を行うAPI
SY-002 同義語 取得 API 同義語の一覧を取得するAPI
SY-003 同義語 削除 API 同義語を削除するAPI

※盛Q = あるQ&Aの質問に対して、別の表現の質問のことです。

  • Q「お花の寿命を延ばすには?」
  • A「こまめに手入れして下さい」

のQ&Aを登録したとして、このQ&Aの盛Qとして、

  • 盛Q「お花を長持ちさせるには?」 等を登録します。

  • 以下、各APIの{API_URL}には、環境毎のAPI URLを設定して下さい。(API利用希望者様にお知らせ致しますので、お問合せ下さい。)
  • 以下、パラメータのサイズは、stringの場合は文字数、それ以外の場合はバイト数とします。

Q&A 登録 API|QA-001

Q&A、盛Qの登録や更新を行うAPI

入力

アクセスURI {API_URL}/retrieve
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
question string 10000 質問
answer string 10000 回答
parent_id int 10 盛Qの場合の親のID
id int 10 更新する場合のQAのID
label string 10000 付与ラベルを半角カンマ区切り

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror
id string 255 追加・更新されたQAのID

Q&A 検索 API|QA-002

queryテキストから、近いQuestionを検索し、上位5件を返却するAPI

入力

アクセスURI {API_URL}/retrieve
メソッド GET

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
query string 10000 検索するクエリ
label string 10000 検索するラベルを半角カンマ区切り(OR検索)

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror
result list id,question,answer,parent_id,scoreの結果のリスト

Q&A 削除 API|QA-003

特定IDのQ&Aを削除するAPI

入力

アクセスURI {API_URL}/delete
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
id string 255 削除するQAのID

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror

全Q&A 取得 API|QA-004

登録済みのQ&Aを全て取得するAPI

入力

アクセスURI {API_URL}/get_all_qa
メソッド GET

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror
result string 255 id,question,answer,parent_id の結果のリスト

盛Q 削除 API|QA-005

特定IDのQ&Aの盛Qを全て削除するAPI

入力

アクセスURI {API_URL}/delete_children
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
id string 255 盛Qを削除する親のQAのID

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror

コミット API|QA-006

Q&Aの登録後やシノニム登録後、学習を行うためのAPI

入力

アクセスURI {API_URL}/commit
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror

同義語 登録 API|SY-001

同義語の登録や更新を行うAPI

入力

アクセスURI {API_URL}/synonym
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
original string 255 オリジナルの語
synonym string 255 オリジナルの同義語となる語

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror

同義語 取得 API|SY-002

同義語の一覧を取得するAPI

入力

アクセスURI {API_URL}/get_all_synonyms
メソッド GET

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror
data list synonym,originalのhashのリスト

同義語 削除 API|SY-003

同義語を削除するAPI

入力

アクセスURI {API_URL}/delete_synonym
メソッド POST

パラメーター

Key サイズ 必須 値の説明
API_KEY string 255 与えられたAPIキー
original string 255 オリジナルの語
synonym string 255 オリジナルの同義語となる語

出力(返却データ:JSON形式)

JSON Key サイズ 必須 値の説明
status string 255 結果のステータス。success またはerror