ビギナーズガイドByHoriuchiYasuhiro-2017/4/61176フェイスブックでシェアツイッターでツイートAPIは、あらゆるソフトウェアサービスプロバイダの標準コンポーネントになりつつあります。オープンなAPIを利用することにより、開発者は自分の好きなプログラミング言語を使用してサービスプロバイダと対話することができます。特定のタスクを実行するためにWebコンソールにログインする代わりに、自動化されたマシンが、ユーザーの代わりに定期的なアクションを実行することができます。このような背景から、MobingiもAPIリファレンスを公開しています。このAPIはすでにMobingiをご利用頂いている方々に先行して公開し、実際に試していただき、貴重なフィードバックをたくさんいただいております。私たちはそのフィードバックをもとに、品質を絶えず向上させることに努めています。ALMの機能を操作する方法について説明します。Webコンソール自体もこのAPIをコールするHTML+CSS+Javascriptで構築されたフロントエンドアプリケーションに過ぎません。APIの利用方法を見ていきましょう。ALMにログインし、一般設定のページに進んでください。Applicationsタブをクリックすると、次の画面のようなページが表示されます。ここから取得できるclient_idとclient_secretは、次のステップで使用します。何も表示されない場合は、こちらの申し込みフォームからclient_idとclient_secretの発行をお申込みいただけます。access_tokenを取得するMobingiのAPIはRESTを中心に構成されており、認証にはOAuth2を使用します。そのため、アプリケーションはまず、OAuth2認証を行う必要があります。OAuthについての詳細はこちらを御覧ください。“client_credentials“で、client_idとclient_secretの値はステップ1で取得した値です。'{"grant_type":"client_credentials","client_id":"lg-5447826c870e7-xBENZSJEN-tm","client_secret":"xBENZSJEN7zl!xjfp7HPp4&zk8Y"}'リクエストが成功すると次のようなレスポンスが返ってきます。:{"token_type":"Bearer","expires_in":43200,"access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjI1NjMyZTIxZDU3MTQ4MGQ2MTA3MGUxNGFlMzg1YTVkZDdjMDQ1YjViYjk2ZjkzMzU0MmQ0ZTM5MzkxNTQyOWQ4ZDZiNDIzNmYzOTYxZjFhIn0.eyJhdWQiOiJsZy01NDdiZDBiOGJlMTIwLUxycjRvR1ZJQy10bSIsImp0aSI6IjI3NjMyZTIxZDU3MTQ4MGQ2MTA3MGUxNGFlMzg1YTVkZDdjMDQ1YjViYjk2ZjkzMzU0MmQ0ZTM5MzkxNTQyOWQ4ZDZiNDIzNmYzOTYxZjFhIiwiaWF0IjoxNDkxMjE4MzA3LCJuYmYiOjE0OTEyMTgzMDcsImV4cCI6MTQ5MTI2MTUwNywic3ViIjoiIiwic2NvcGVzIjpbXX0.nhgv4uyT6itQ7PeLXoO1CaR--x4OzyYSSazByeF97Fn-q-EgduY-zYa5Us8TG73NV1teSQK4d0o3KZ-1xA7j8Za7GEb5lM3hBJAvAo23tt_1YP-VQA5z4MACdpOufywQmTNW0dolPkM8lkVfAMb_kLgN7X1ZxEeGxu6c2xyTRNQ"}ご覧のようにレスポンス本文からaccess_tokenの値を取得できます。これ以降のAPIコールでは、この値をAuthorizationヘッダーに設定する必要があります。このトークンは、API認証のユーザー名とパスワードのペアのように動作します。デフォルトのトークン有効期限は12時間です。ALMで管理しているスタックの一覧を取得するAPIリクエストの例は次のとおりです。\スタックをまだ一つも作成していない場合は、HTTPステータス200と共に空のボディが返ってきます。スタックを作成している場合は(Webコンソールから最初にスタックを作成できます)、次のようなJSON形式のレスポンスが返されます。APIは簡単に使い始めることができます。すべてのAPIコールでベアラートークンをAuthorizationヘッダーに渡すだけです。APIは、予測可能なリソース指向のURLを持つように設計されています。Sharing)もサポートしていますので、安全かつ柔軟に自身のサイト上にWebコンソールを構築することができます。次のステップ使用可能なAPIエンドポイントの一覧については、完全なドキュメントを参照してください。ALMを使って運用しています。運用をはじめて半年ですが、非常に安定しています。APIサーバーのステータスを監視するためのスタンドアロンのページも用意しています。:http://status.mobingi.comこのページでは稼働時間、RPM、応答時間などの情報を提供しています。すべてのインシデントもこのページに公開されます。サーバーはNewRelicで監視しています。こちらが前週のパフォーマンスのスクリーンショットです。幸運にも、100%の稼働時間を達成しました!先週のAPIリクエストの総数は約967,000と、その数はそれほど多くはありませんでしたが、日を追う毎にこの数字が大きくなっています。このままの勢いで成長していけば、今後数ヶ月間に10倍の成長が見込まれています。直近のAPIサーバーのパフォーマンスの詳細はこのようになっています。