ポイント&クリックだけでDB からREST API を作成できるCData API Server で、MySQL のデータからREST API を作ります。

##CData API Server をインストール##
http://www.cdata.com/jp/apiserver/
今回は、Windows 版で説明しています。
インストーラに従って、インストールを行ってください。

Windows 版もしくはJava/Linux 版を選択します。

インストール完了後にブラウザでAPI Server の管理コンソール画面が立ち上がります。インストール時に設定したadmin パスワードを入力してログインします。

管理コンソールで「情報」タブをクリックし、「30日の評価版をアクティベートする」をクリックします。
これで30日間の使用ライセンスが製品に設定されます。

##MySQL とAPI Server の接続を確立##
まずはこちらがデータソースとなるMySQL です。sakila というデモデータがあり、city というテーブルがあります。これをWeb API として公開します。
デモデータの落とし方

API Server のコンソールをブラウザで開きます。Windows メニューからCData API Server を開くと自動的にブラウザが立ち上がります。admin アカウントでログインします。

［設定］タブから［接続］をクリックします。
接続可能なデータソースが並んでいます。表示されているデータソースだけでなく、CData の対応する80以上のデータソースをAPI のデータソースとすることが可能です。

ここからMySQL のアイコンをクリックします。
MySQL の接続設定画面が開くので、接続情報を入力します。

名前：任意
データベース：MysQL がプリセット
Server、Port、User、Password をDB の情報に沿って入力
入力して［テスト接続］を試し、成功したら［保存］します。

##API として公開するリソースの設定##
［設定］→［リソース］をクリックして、リソースを追加するウィザードを開きます。
先ほど作成した接続をクリックして、［OK］を押します。

リソースとするテーブルのリストが表示されますので、選択して［OK］を押します。

続いて、テーブル内のカラムのリストが出るので、リソースとするカラムをチェックします。

これでAPI として公開するリソース設定が完了です。

##セキュリティ設定##
ユーザー認証の設定を行います。［設定］→［ユーザー］→［追加］でユーザーを追加します。
ユーザー名とGET、POST、PUT、DELETE などの権限を付与、レートリミットを設定します。

［保存］すると新しいユーザーが追加され、Auth トークンが発行されます。

これで設定は完了です。

##ブラウザからAPI を叩いてみる##
まずは、［API］タブからドキュメントを参照します。上のリソース設定のプロセスを行うとドキュメントは自動生成されます。
リソースの下のエンドポイント名をクリックするとAPI ドキュメント参照できます。
GET、POST、PUT、DELETE それぞれのURL およびJavaScript/CURL でのAPI のリクエスト方法やパラメータが記載されています。

GET の脇の　http://localhost:8387/api.rsc/RESOURSE/ をブラウザで叩いてみましょう。初回はAuth トークンの認証が要求されます。上で作成したユーザー名とAuth トークンを入力します。
たしかに、JSON 形式でMySQL 内のデータが返ってきました。

すこしJSON が見やすいPOSTMAN というツールからも試してみましょう。

このように、ポチポチとクリックするだけで、DB からREST API が作れてしまいました。