步驟 1:建立 API Proxy

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

本節說明如何建立簡單的 API Proxy。

邊緣

如要使用 Edge UI 建立 API Proxy,請按照下列步驟操作:

  1. 登入 apigee.com/edge
  2. 在主視窗中點選「API Proxy」

  3. 按一下「+Proxy」

    可建立 Proxy

    Apigee 會逐步引導您建立新的 Proxy。首先,請選取 Proxy 類型:

  4. 按一下「Reverse proxy (most common)」

    Apigee 會顯示「Proxy details」(Proxy 詳細資料) 頁面。

  5. 請按照下列步驟設定 Proxy 詳細資料:
    • 名稱:輸入 getstarted。如果已有同名的 Proxy,請改用其他名稱。
    • 基本路徑:確認已設為 /getstarted

      基本路徑是網址的一部分,用於向 API 發出要求。Edge 會使用這個網址比對傳入要求,並將要求轉送至適當的 API Proxy。

    • 說明 (選填):輸入新 API Proxy 的說明,例如「開始使用 Proxy」
    • 目標 (現有 API):輸入 https://mocktarget.apigee.net。這會定義 Apigee Edge 在對 API Proxy 發出要求時,所叫用的目標網址。

      mocktarget 服務代管於 Apigee,並會傳回簡單的資料。不需要 API 金鑰或存取權杖。

    Proxy 的詳細資料應如下所示:

  6. 點選 [下一步]。
  7. 在「Common policies」(通用政策) 頁面的「Security: Authorization」(安全性:授權) 下方,確認已選取「Pass through (no authorization)」(直通 (無授權)),然後按一下「Next」(下一步)

  8. 在「虛擬主機」頁面中,選取「default」和「secure」,然後按一下「下一步」
  9. 在「摘要」頁面,確認已在「選用部署」下方選取「測試」環境,然後按一下「建立並部署」

    Apigee 會建立新的 API Proxy,並部署至測試環境:

  10. 按一下「Edit proxy」,即可顯示 API Proxy 的「Overview」頁面:

    請注意,如果展開「[ + ]」,使用者介面會列出測試環境的 HTTP 和 HTTPS 網址:

    因此,您可以傳送要求至任一端點,但本教學課程使用 HTTPS。

Classic Edge (Private Cloud)

如要使用 Classic Edge UI 建立 API Proxy,請按照下列步驟操作:

  1. 登入 http://ms-ip:9000,其中 ms-ip 是管理伺服器節點的 IP 位址或 DNS 名稱。
  2. 在主視窗中點選「API Proxy」

  3. 按一下右上方的「+ API Proxy」

    可建立 Proxy

    Apigee 會逐步引導您建立新的 Proxy。第一個決定是 Proxy 類型:

  4. 選取「Reverse proxy (most common)」(反向 Proxy (最常見)),然後點選「Next」(下一步)

    Apigee 隨即會顯示「詳細資料」畫面。

  5. 使用下列設定配置 Proxy:
    • Proxy Name:輸入「getstarted」。如果已有同名 Proxy,請選擇其他名稱。
    • Proxy 底層路徑:確認已設為「/getstarted」。

      Proxy Base Path 是用來向 API 提出要求的網址一部分。Edge 會使用這個網址比對傳入要求,並將要求轉送至適當的 API Proxy。

    • 現有 API:輸入「https://mocktarget.apigee.net」。這會定義 Apigee Edge 在對 API Proxy 發出要求時叫用的目標網址。

      mocktarget 服務代管於 Apigee,並會傳回簡單的資料。不需要 API 金鑰或存取權杖。

    • (選用) 說明:輸入新 API Proxy 的說明,例如「入門代理伺服器」。

    Proxy 的詳細資料應如下所示:

  6. 點選 [下一步]。
  7. 在「安全性」畫面上,選取「Pass through (none)」做為安全性選項,然後按一下「下一步」

  8. 在「虛擬主機」畫面中,接受預設選取項目,然後按一下「下一步」
  9. 在「建構」畫面上,確認「部署環境」旁已選取「測試」環境,然後點按「建構並部署」

    Apigee 會建立新的 API Proxy,並部署至測試環境:

  10. 按一下「在編輯器中查看 getstarted proxy」,顯示 API Proxy 的「總覽」頁面:

    請注意,如果展開「[ + ]」,使用者介面會列出測試環境的 HTTP 和 HTTPS 網址:

    因此,您可以傳送要求至任一端點,但本教學課程使用 HTTPS。

下一步

步驟 1 步驟 2:測試新 Proxy 步驟 3 步驟 4