オリジナル処理と紐づいたAPIエンドポイントを作成する

Kurocoではオリジナル処理と紐づいたエンドポイントの作成ができます。

オリジナル処理を利用することのメリット

オリジナル処理を利用することで、APIエンドポイントの標準機能だけでは実現が難しい処理を自由に追加できます。そのため、様々なユースケースに柔軟に対応できます。

例として、下記対応が可能です。

• リクエスト/レスポンス内容を変更する
• APIへの処理をフックする
• 独自のセキュリティ制御を実装する

このチュートリアルでは、オリジナル処理とエンドポイントを紐付ける方法を紹介します。

GETエンドポイントとオリジナル処理を作成する

まずはGETエンドポイントの例を紹介します。
ここでは例として、PlainCustomFunctionという名前のオリジナル処理をAPIエンドポイントと紐付けます。

GETエンドポイントを作成する

オリジナル処理と紐づけるためのエンドポイントを作成します。

エンドポイント一覧画面より、[エンドポイントの設定]をクリックします。

今回は下記のように作成しました。

GETエンドポイント用のオリジナル処理を作成する

次に、作成したGETエンドポイント用のオリジナル処理を作成します。

オリジナル処理一覧画面より、[追加]をクリックします。

下記の設定で作成します。

{* シンプルなダミー文字列を返します。 *}
{capture name=data}
{literal}
    responce text
{/literal}
{/capture}
{assign var=data value=$smarty.capture.data}

GETエンドポイントの動作確認をする

それでは、作成したエンドポイントの動作確認をします。 今回はSwaggerUI画面から確認します。

エンドポイント一覧画面より、[Swagger UI]をクリックします。

先ほど作成した、plain-custom-endpointをクリックします。

[Try it out]をクリックします。

[Execute]をクリックします。

すると、Response bodyにオリジナル処理で作成した内容が表示されていることが確認できます。

以上で、GETエンドポイントとオリジナル処理の紐付け完了です。

POSTエンドポイントとオリジナル処理を作成する

次に、POSTエンドポイントの例を紹介します。 ここでは例として、PlainCustomFunctionPostという名前のオリジナル処理を作成することとし、サマリー/ディスクリプションに説明例を記載しています。

POSTエンドポイントを作成する

オリジナル処理と紐づけるためのエンドポイントを作成します。

エンドポイント一覧画面より、[エンドポイントの設定]をクリックします。

今回は下記のように作成しました。

POSTエンドポイント用のオリジナル処理を作成する

次に、作成したPOSTエンドポイント用のオリジナル処理を作成します。

オリジナル処理一覧画面より、[追加]をクリックします。

下記の設定で作成します。

{* シンプルなダミー文字列を返します。 *}
{capture name=data}
{literal}
    responce text
{/literal}
{/capture}
{assign var=data value=$smarty.capture.data}

POSTエンドポイントの動作確認をする

それでは、作成したエンドポイントの動作確認をします。 今回はSwaggerUI画面から確認します。

エンドポイント一覧画面より、[Swagger UI]をクリックします。

先ほど作成した、plain-custom-endpoint-postをクリックします。

[Try it out]をクリックします。

[Execute]をクリックします。

すると、Response bodyにオリジナル処理で作成した内容が表示されていることが確認できます。

以上で、POSTエンドポイントとオリジナル処理の紐付け完了です。

オリジナル処理の実装例について

以上でオリジナル処理とAPIエンドポイントの紐付け方法の紹介を終わります。 このチュートリアルではシンプルに紐付けの方法のみの説明にとどめましたが、オリジナル処理の実装についてもっと詳しく知りたい場合は、下記ユースケース別のチュートリアルを参照してください。

• オリジナル処理を利用して、APIエンドポイントに独自のスタブを設定する
• オリジナル処理を利用して、APIに独自のバリデーションを実装する
• オリジナル処理を利用して、APIのメイン処理に渡すリクエスト値を書き換える