32.4. 実際の実装

32.4.1. 最高のレシピ

カスタム作業を行う際に、このレシピでより良い結果が得られます。

  • ActiveDocs について少し見てみましょう。3scale ActiveDocs は、管理ポータルの Account Settings (右上隅の歯車アイコン) > Integrate > 3scale API Docs から利用可能です。3scale の API は、すべて ActiveDocs として利用可能です。したがって、ブラウザーから使用することができます。これにより、ニーズに最適なリクエストを探し、リクエスト (curl に類似) を取得し、レスポンスを得ることができます。以下に例を示します。

    DIY Analytics

これは、解析機能を拡張するスクリプトで使用されるすべてのアプリケーションを取得する API リクエストの ActiveDocs です。

  • ActiveDocs の調査を完了したら、リクエストを好みのスクリプト言語に落とし込みます (当社の場合は平凡な Ruby です)。
  • 希望の処理を実行するスクリプトが書き上がるまで、この作業を繰り返します。解析機能の拡張を例に取ると、ここから スクリプトを確認することができます。これをご自分のアカウントで試すことができます。

ActiveDocs により、API のできることを素早く理解することができます。後は、実行したいタスクに必要な 3 つか 4 つのリクエストを探し、スクリプトを 1 つにまとめます。