これは、日本語プログラミング言語「なでしこ3」のためのWeb APIです。ブラウザ上で動くなでしこのプログラムから、データをサーバーに保存するためのWeb APIです。
そもそも、ブラウザ上で動く「なでしこ3」で、サーバーにデータを保存するためには、自分でサーバーを持っており、データの保存APIを自分で作らなくてはなりません。これは、それなりにハードルが高いものです。しかし、この簡単保存API(nako3kvs/なでしこ3Key-Value-Store)を使えば、手軽にサーバーにデータを保存できます。
例えば、ゲームのハイスコアや、メッセージボードの作成、ちょっとしたユーザーデータの保存などに使えます。
この機能を使うと、ブラウザの「なでしこ3」から、サーバーにデータを保存できます。例えば、「test」というキーに「hoge」という値を記録したとします。すると、いつでも「test」というキーを使って「hoge」という値を取得することができます。
保存できるのは文字列のみですですが、JSONエンコード、JSONデコードを使えば、複雑なデータも保存可能になります。
なお、nako3kvsは次の手順で利用します。
最初に、自分が使いたいキーを作成しましょう。キーの作成は、こちらの管理画面から行ってください。
いくつでも作成できます。キーの作成にはパスワードが必要です。このパスワードは閲覧・変更に必要なので忘れないようにしましょう。
以下のようにして指定のキーをサーバーより取得できます。(ただし、なでしこ3簡易エディタは「取り込む」をサポートしていません。テストは、なでしこ3貯蔵庫をご利用ください。)
以下のように『KVS設定』命令を利用して値を変更できます。以下の例では毎回異なる値を書き込みます。
以下のGETリクエストを送信するとデータを閲覧できます。
[URL] https://nadesiko.net/nako3kvs/api.php?mode=get&key=(キー名)&password=(パスワード)
以下のGETリクエストを送信するとデータを変更できます。
[URL] https://nadesiko.net/nako3kvs/api.php?mode=set&key=(キー名)&value=(新しい値)&password=(パスワード)&time=(更新日時UNIXTIMEミリ秒)