download top

ドキュメント (0.10.x)

Kong がどのようにして API を加速していくのか学びましょう。

注意! 現在閲覧中のドキュメントは、Kong の旧バージョンです。最新のドキュメントは、こちらからご覧ください。

API の追加


始める前に:
  1. 必ず Kong をインストールしてください - インストールは数分で完了します!
  2. 次に、Kong が起動していることを確認してください。

このセクションでは、Kong レイヤーに対する API の追加方法を学ぶことができます。これは、API を Kong によって管理するための第一歩となります。このスタート ガイドでは、Kong による API リクエストのプロキシ方法を学ぶのに最適な Mockbin API を Kong へ追加することを推奨します。

Kong インスタンスまたはクラスタの設定を管理するため、Kong はポート :8001 上に RESTful Admin API を公開します。


  1. Admin API を使用した API の追加

    以下の cURL リクエストを実行して、1 つ目の API (Mockbin) を Kong へ追加します:

    $ curl -i -X POST \
      --url http://localhost:8001/apis/ \
      --data 'name=example-api' \
      --data 'hosts=example.com' \
      --data 'upstream_url=http://httpbin.org'
    
  2. API が追加されたことを確認

    リクエスト後、以下のようなレスポンスが表示されます:

    HTTP/1.1 201 Created
    Content-Type: application/json
    Connection: keep-alive
    
    {
      "created_at": 1488830759000,
      "hosts": [
          "example.com"
      ],
      "http_if_terminated": true,
      "https_only": false,
      "id": "6378122c-a0a1-438d-a5c6-efabae9fb969",
      "name": "example-api",
      "preserve_host": false,
      "retries": 5,
      "strip_uri": true,
      "upstream_connect_timeout": 60000,
      "upstream_read_timeout": 60000,
      "upstream_send_timeout": 60000,
      "upstream_url": "http://httpbin.org"
    }
    

    ここまでで、Kong は API を認識し、リクエストをプロキシする準備が整いました。

  3. Kong を介したリクエストの転送

    以下の cURL リクエストを実行して、Kong がリクエストを適切に API へ転送していることを確認してください。デフォルト設定の Kong は、ポート :8000 上でプロキシ リクエストを処理します:

    $ curl -i -X GET \
      --url http://localhost:8000/ \
      --header 'Host: example.com'
    

    レスポンスが成功した場合、http://localhost:8000 へ送信されたリクエストは、手順 1 で設定した upstream_url へ転送され、レスポンスが返還されます。Kong は、上記の cURL リクエストで定義されたヘッダーを通して、自動的に動作します:

    Host: <指定されたホスト>

  4. 次のステップ

    ここまでで、API を Kong へ追加することができたので、次にプラグインを有効化する方法を学びましょう。

    プラグインの有効化」を参照する。

価格/お問い合わせ

製品の詳細、価格、ライセンス体系、デモの依頼など、お気軽にお問い合わせください。