APIによるビジネス化 - apigeeを使ってみる

APIによるビジネス化を検討します
apigeeを使ってみます

0. apigeeにサインアップします

• apigeeのサイトへアクセスしてフリートライアルのユーザーIDを取得します

• メールが届くのでその中のリンクをクリックするとactivateされます
• 自分用の組織（「ユーザー名-trial」などの名称になります）が作成されるまで少し時間がかかります（３０分程度など）
• 組織が作成されるとApigeeのログイン画面左上の自分のユーザーIDのプルダウンで自分用の組織（「xxxxx-trial」など）が選択可能になります

1. チュートリアル１：OpenAPIの仕様の作成

• apigee - Get Startedに従って進めていきます
• Tutorial: Create an OpenAPI SpecificationでOpenAPIの仕様を作成してみます（実際のAPI作成は行われません）

2. チュートリアル2：APIの作成

• apigee - Get Startedの２つめのチュートリアルです
• Tutorial: Create an API proxy from a specificationでAPIを作成してみます
• Apigeeが提供するmocktargetサービス（「Hello, Guest」を返します）を使用します

• 画面右上の「+Spec」プルダウンメニューから「Import URL」を選択します
  

• 「Import Name」に「mocktarget」、「Import URL」に「https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml」 を指定し、Importを押します

• Importされたサービスを表示してみます

• 次にこのサービスへアクセスする「APIプロキシー」を作っていきます
• Develop⇢Specsを選択し、作成された「mocktarget」 サービスをメニュー表示した状態で、右端の「More」メニューから「Generate API Proxy」を選択します
• 「Details」画面はそのまま「Next」、次の「Flows」画面はすべての項目が選択されている（　デフォルト）ことを確認し「Next」、「Security」画面では「Pass through(none）」を選択して「Next」、「Virtual Host」画面ではすべて選択されていることを確認して「Next」、「Build」画面は「Test」が選択されている（デフォルト）ことを確認し、画面右下の「Build and Deploy」ボタンを押してAPIプロキシーを生成します
• 画面が「Generated Proxy」、「Uploaded proxy」、「Deployed to test」と完了（緑色に変化）し、「View mocktarget-．．．」メニューが表示されたら作成されたAPIプロキシーを開いてみます
• 画面中央に作成されたAPIプロキシーのURLが表示されています
• 作成されたAPIプロキシーを確認するため、curl http://<org_name>-test.apigee.net/mock-target-apiもしくはブラウザで同URLをアクセスしてみます
• 設定がうまくいっていれば、Hello,Guest!が返されます
• 同様に、curl http://<org_name>-test.apigee.net/mock-target-api/xmlもしくはブラウザで同URLをアクセスします
• 設定がうまくいっていれば、{"root":{"city":"San Jose","firstName":"John","lastName":"Doe","state":"CA"}}などJSON形式で結果が返されます

3. チュートリアル3：APIの公開

• apigee - Get Startedの３つめのチュートリアルです
• Tutorial: Publish your APIでAPIの公開を試してみます

• 画面右上の「+Spec」プルダウンメニューから「Import URL」を選択します
  

• 「Import Name」に「foodcarts」、「Import URL」に「https://raw.githubusercontent.com/apigee/streetcarts/master/streetcarts/specs/openapi/foodcarts.yaml」 を指定し、Importを押します

• Importされたサービスを表示してみます

• 次に前項と同様にこのサービスへアクセスする「APIプロキシー」を作っていきます
• Develop⇢Specsを選択し、作成された「footcarts」 サービスをメニュー表示した状態で、右端の「More」メニューから「Generate API Proxy」を選択します
• 「Details」画面はそのまま「Next」、次の「Flows」画面はすべての項目が選択されている（　デフォルト）ことを確認し「Next」、「Security」画面では「Pass through(none）」を選択して「Next」、「Virtual Host」画面ではすべて選択されていることを確認して「Next」、「Build」画面は「Test」が選択されている（デフォルト）ことを確認し、画面右下の「Build and Deploy」ボタンを押してAPIプロキシーを生成します
• 画面が「Generated Proxy」、「Uploaded proxy」、「Deployed to test」と完了（緑色に変化）し、「View foodcarts-．．．」メニューが表示されたら作成されたAPIプロキシーを開いてみます
• 画面中央に作成されたAPIプロキシーのURLが表示されています
• 次にこのAPIを公開していきます
• Apigeeのコンソールから「Publish」→「API Products」を選択します
• 画面右上の「＋API Product」を押し、「Product Detail」画面で、「Name」欄に「StreetCarts」、「Display Name」欄に「StreetCarts」、「Description」欄に「StreetCarts API」、「Environment」は「Test」を選択し、「Access」は「Public」を選択し、「Key Approval Type」は「Automatic」（デフォルト）が選択されていることを確認し、「Quota」と「Allowed OAuth Scope」は空欄（ブランク）のままとします。
• 「Resource」セクションの「API Proxy」プルダウンメニューを開き、「Food-Carts−API」を選択し、「Revision」は「１」、「Resource Path　」は「/」を選択します。「Import Resource」を押すとPathsとAPI Proxies欄に値が設定されます。

• 「Publish」⇢「Portals」を選択します。「+Portal」を押し、「Name」欄に「myportal」、「Description」欄に「My first portal」等と入力します。
• 「Create」を押しAPIポータルを作成します

• ポータル画面右上の「APIs」を開いても、この時点ではAPIが登録されていないことを確認します
• 前項までに作成したStreetCartsAPIをポータルへ追加して公開します
• 「Publish」⇢「portals」から上記で作成した 「myportal」を選択します。URLをクリックするとポータル画面へ遷移してしまうので、「myportal」の名前の部分をクリックする点に注意します。
• 表示するメニュー画面から「APIｓ」を選択します

• 画面右上の「＋API」を押してAPIを追加していきます

• 表示されるAPI一覧から「StreetCarts」APIを選択し、「Add Spec Snapshot」を押します。
• 「Publish」が選択されていることを確認し、「Review」で内容を確認したのち、「Save & Complete」を押してAPIを公開します
• ポータル画面から「APIｓ」を選択すると、公開したAPIが表示されることを確認します