しりとり API
しりとりでは、API を提供しています。
この API を使えば誰でも面倒な文字列操作やデータベースの準備をせずに、自分なりにカスタマイズした学習型しりとりサイトを構築することが可能です。
しりとり API を利用するには
しりとり API を利用するには API キーを取得していただく必要があります。取得にはサイト URL とメールアドレスが必要です。(メールアドレスは確認用に使い、当サイトで管理しませんのでご安心ください。)
しりとり API キーを取得する - しりとり
しりとり API の仕組み
しりとり API は XML により提供されています。例えば「ぶっしゅ」という言葉を投げる場合、以下のようにします。
http://siritori.net/api/v1/apikey/normal/%82%D4%82%C1%82%B5%82%E3
apikey の部分にはご自分の API キーを入れます。
normal の部分はどのような言葉を返してもらうか、当サイトで言うモードを入れます。他には safe、none などがあります。詳しくは後で説明させていただきます。
%82%D4%82%C1%82%B5%82%E3 の部分は「ぶっしゅ」を URL エンコードした値になっています。ちなみに URL に日本語を使うことはできません。この辺りが分からない方は調べてみてください。
返ってくる XML は以下のような感じです。(サンプルなので一部省略します。)
<?xml version='1.0' encoding='UTF-8'?> <siritori key="apikey" num="6" date="2009-11-14" time="01:48:52"> <item> <id>53</id> <word>ゆりかご</word> <url>http://siritori.net/words/%E3%82%86%E3%82%8A%E3%81%8B%E3%81%94</url> <type>safe</type> </item> <item> <id>677</id> <word>ゆ</word> <url>http://siritori.net/words/%E3%82%86</url> <type>safe</type> </item> <item> <id>798</id> <word>ゆうき</word> <url>http://siritori.net/words/%E3%82%86%E3%81%86%E3%81%8D</url> <type>safe</type> </item> </siritori>
キーワード毎に item で区切られています。
id にはキーワードの番号が入っております。これは固定なので、今までに言った言葉を記憶する際などにご活用ください。
word にはキーワードが入っています。
url には当サイトのその言葉のページへのリンクがあります。
type にはその言葉の分類が入っています。セーフモードなのかノーマルモードなのかと言った感じです。
いろいろ複雑ですね。それでは、これから詳しい説明をしていきたいと思います。
モードについて
モードについての詳しい説明は、モードについてを参照していただければと思います。
| 値 | モード | 説明 |
|---|---|---|
| safe | セーフモード | 管理人がセーフだと思ったキーワードを返します。 |
| normal | ノーマルモード | 管理人がノーマルだと思ったキーワードを返します。 |
| none | ノンフィルターモード | 管理人関係なしに全てのキーワードを返します。 |
エラー文について
しりとり API の凄いところ。どんな言葉を投げていただいても構いません。こちらで全て処理します。
エラーを出すタイミングを一覧にします。(日本語ですみません。今後改善されるかもしれませんね。)
| エラー文 | タイミング |
|---|---|
| 何も入力されていません。何か入力してください。 | 何もキーワードが入力されていない時。 |
| 言葉はひらがなで入力してください。 | ひらがなと「・」と「ー」以外の文字が入っている時。 |
| 「ん」から始まる言葉は禁止です。 | キーワードが「ん」から始まる時。 |
| 最初が「ー」で始まる文字は禁止です。 | キーワードが「ー」から始まる時。 |
| 先頭あるいは後尾が「・」になる文字列は禁止です。 | キーワードの先頭あるいは後尾が「・」になる時。 |
| 言葉の後尾が「ん」なのであなたの負けです。 | キーワードの後尾が「ん」の時。 |
| 禁止ワードになります。他の言葉を入力してください。 | キーワードが当サイトの禁止ワードに該当する時。 |
エラー文はそのまま使うと楽かもしれません。
API を利用したサイトの提案
しりとり API は今まで投げた言葉の記憶はしません。単純に見ると使えないように感じるかもしれません。そう思われて終わってしまうと悲しいのでいくつか提案をします。
1. 「る」攻めしりとり
めちゃめちゃ「る」攻めをしてくるしりとりです。こっちも「る」攻めしよう。
2. 文字数制限しりとり
3文字の言葉だけでしりとりしてみます。
3. キャラクターしりとり
ゲームのキャラクターやモンスター名だけでしりとりをします。
4. 難易度しりとり
当サイトの CPU は常にフルパワーで戦ってきますので、制限をかけてあげてください。
5. 時間制限しりとり
5秒以内に次の言葉が言えなかったら負けしりとり。
しりとり API を使えば、面倒な文字列の処理や学習機能の実装、データベースの準備、初期段階でのキーワードの充実、禁止ワードなどの管理など、複雑で面倒な準備をすることなく、オリジナルのしりとりサイトを作ることが可能です。ぜひ挑戦してみてください。
ひとつのデータベースを基盤にみんなでしりとりサイトを作っていけば、より強いデータベースの育成と無駄の削減になりますよね。ぜひいろいろなサイトを作ってください。