APIDokumentasi impor - APIGerbang Amazon
Mengimpor bagian dokumentasi menggunakan Gateway API REST APIMengimpor bagian dokumentasi menggunakan konsol API Gateway

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

APIDokumentasi impor

Seperti halnya mengimpor definisi API entitas, Anda dapat mengimpor bagian dokumentasi dari API file Open eksternal ke API dalam API Gateway. Anda menentukan bagian to-be-imported dokumentasi dalam x-amazon-apigateway-documentation objek ekstensi dalam file API definisi Terbuka yang valid. Mengimpor dokumentasi tidak mengubah definisi API entitas yang ada.

Anda memiliki opsi untuk menggabungkan bagian dokumentasi yang baru ditentukan ke dalam bagian dokumentasi yang ada di API Gateway atau untuk menimpa bagian dokumentasi yang ada. Dalam MERGE mode, bagian dokumentasi baru yang ditentukan dalam API file Open ditambahkan ke DocumentationParts koleksi fileAPI. Jika impor DocumentationPart sudah ada, atribut yang diimpor menggantikan yang sudah ada jika keduanya berbeda. Atribut dokumentasi lain yang ada tetap tidak terpengaruh. Dalam OVERWRITE mode, seluruh DocumentationParts koleksi diganti sesuai dengan file API definisi Terbuka yang diimpor.

Mengimpor bagian dokumentasi menggunakan Gateway API REST API

Untuk mengimpor API dokumentasi menggunakan API Gateway RESTAPI, panggil operasi documentationpart:import. Contoh berikut menunjukkan cara menimpa bagian dokumentasi yang ada API dengan GET / metode tunggal, mengembalikan 200 OK respons saat berhasil.

OpenAPI 3.0
PUT /restapis/<restapi_id>/documentation/parts&mode=overwrite&failonwarnings=true
Host: apigateway.region.amazonaws.com
Content-Type: application/json
X-Amz-Date: YYYYMMDDTttttttZ
Authorization: AWS4-HMAC-SHA256 Credential=access_key_id/YYYYMMDD/region/apigateway/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=sigv4_secret

{
   "openapi": "3.0.0",
   "info": {
      "description": "description",
      "version": "1",
      "title": "doc"
   },
   "paths": {
      "/": {
         "get": {
            "description": "Method description.",
            "responses": {
               "200": {
                  "description": "200 response",
                  "content": {
                     "application/json": {
                        "schema": {
                           "$ref": "#/components/schemas/Empty"
                        }
                     }
                  }
               }
            }
         }
      }
   },
   "x-amazon-apigateway-documentation": {
      "version": "1.0.3",
      "documentationParts": [
         {
            "location": {
               "type": "API"
            },
            "properties": {
               "description": "API description",
               "info": {
                  "description": "API info description 4",
                  "version": "API info version 3"
               }
            }
         },
         {
            "location": {
               "type": "METHOD",
               "method": "GET"
            },
            "properties": {
               "description": "Method description."
            }
         },
         {
            "location": {
               "type": "MODEL",
               "name": "Empty"
            },
            "properties": {
               "title": "Empty Schema"
            }
         },
         {
            "location": {
               "type": "RESPONSE",
               "method": "GET",
               "statusCode": "200"
            },
            "properties": {
               "description": "200 response"
            }
         }
      ]
   },
   "servers": [
      {
         "url": "/"
      }
   ],
   "components": {
      "schemas": {
         "Empty": {
            "type": "object",
            "title": "Empty Schema"
         }
      }
   }
}
OpenAPI 2.0
PUT /restapis/<restapi_id>/documentation/parts&mode=overwrite&failonwarnings=true
Host: apigateway.region.amazonaws.com
Content-Type: application/json
X-Amz-Date: YYYYMMDDTttttttZ
Authorization: AWS4-HMAC-SHA256 Credential=access_key_id/YYYYMMDD/region/apigateway/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=sigv4_secret

{
  "swagger": "2.0",
  "info": {
    "description": "description",
    "version": "1",
    "title": "doc"
  },
  "host": "",
  "basePath": "/",
  "schemes": [
    "https"
  ],
  "paths": {
    "/": {
      "get": {
        "description": "Method description.",
        "produces": [
          "application/json"
        ],
        "responses": {
          "200": {
            "description": "200 response",
            "schema": {
              "$ref": "#/definitions/Empty"
            }
          }
        }
      }
    }
  },
  "definitions": {
    "Empty": {
      "type": "object",
      "title": "Empty Schema"
    }
  },
  "x-amazon-apigateway-documentation": {
    "version": "1.0.3",
    "documentationParts": [
      {
        "location": {
          "type": "API"
        },
        "properties": {
          "description": "API description",
          "info": {
            "description": "API info description 4",
            "version": "API info version 3"
          }
        }
      },
      {
        "location": {
          "type": "METHOD",
          "method": "GET"
        },
        "properties": {
          "description": "Method description."
        }
      },
      {
        "location": {
          "type": "MODEL",
          "name": "Empty"
        },
        "properties": {
          "title": "Empty Schema"
        }
      },
      {
        "location": {
          "type": "RESPONSE",
          "method": "GET",
          "statusCode": "200"
        },
        "properties": {
          "description": "200 response"
        }
      }
    ]
  }
}

Jika berhasil, permintaan ini mengembalikan respons 200 OK yang berisi impor DocumentationPartId dalam muatan.

{
  "ids": [
    "kg3mth",
    "796rtf",
    "zhek4p",
    "5ukm9s"
  ]
}

Selain itu, Anda juga dapat memanggil restapi:import atau restapi:put, memasok bagian dokumentasi dalam x-amazon-apigateway-documentation objek sebagai bagian dari input Open file definisi. API API Untuk mengecualikan bagian dokumentasi dari API impor, atur ignore=documentation parameter kueri permintaan.

Mengimpor bagian dokumentasi menggunakan konsol API Gateway

Petunjuk berikut menjelaskan cara mengimpor bagian dokumentasi.

Untuk menggunakan konsol untuk mengimpor bagian dokumentasi API dari file eksternal

  1. Di panel navigasi utama, pilih Dokumentasi.

  2. Pilih Impor.

  3. Jika Anda memiliki dokumentasi yang sudah ada, pilih untuk Menimpa atau Menggabungkan dokumentasi baru Anda.

  4. Pilih Pilih file untuk memuat file dari drive, atau masukkan konten file ke dalam tampilan file. Sebagai contoh, lihat payload permintaan contoh diMengimpor bagian dokumentasi menggunakan Gateway API REST API.

  5. Pilih cara menangani peringatan saat impor. Pilih salah satu Gagal pada peringatan atau Abaikan peringatan. Untuk informasi selengkapnya, lihat Kesalahan dan peringatan dari mengimpor Anda API ke Gateway API.

  6. Pilih Impor.