Classic/VPC環境で利用できます。
公開した API説明書の内容を更新します。直接作成した APIでのみ使用できます。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| PATCH | /products/{product-id}/apis/{api-id}/documents |
リクエストヘッダ
API Gatewayで共通して使用されるヘッダの詳細は、API Gatewayのリクエストヘッダをご参照ください。
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
product-id |
String | Required | APIが属する Product ID
|
api-id |
String | Required | 文書を変更する対象 APIの ID
|
リクエスト構文
リクエスト構文は次の通りです。
{
"documentMd" : "string"
}
リクエストボディ
リクエストボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
documentMd |
String | Required | API説明書の内容 |
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request PATCH 'https://apigateway.apigw.ntruss.com/api/v1/products/w1k03m9zo9/apis/cvcohvd2xj/documents' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
"documentMd" : "API文書の説明書"
}'
レスポンス
レスポンス形式を説明します。
レスポンスステータスコード
API Gatewayで共通して使用されるレスポンスステータスコードの詳細は、API Gatewayのレスポンスステータスコードをご参照ください。