公開された Stage文書の照会

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

Classic/VPC環境で利用できます。

指定した Stageに公開された文書を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/products/{product-id}/apis/{api-id}/stages/{stage-id}/swagger-json

リクエストヘッダ

API Gatewayで共通して使用されるヘッダの詳細は、API Gatewayのリクエストヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`product-id`	String	Required	Stageが属する Product ID 0~10文字 Productリストの照会を通じて確認
`api-id`	String	Required	Stageが属する API ID 0~10文字 APIリストの照会を通じて確認
`stage-id`	String	Required	文書を照会する対象の Stage ID 0~10文字 Stageリストの照会を通じて確認

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://apigateway.apigw.ntruss.com/api/v1/products/***ksk9***/apis/***51hs***/stages/***5ei7***/swagger-json' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンス構文

レスポンス構文は次の通りです。

{
    "documentJson" : "documentJson"
}

レスポンスステータスコード

API Gatewayで共通して使用されるレスポンスステータスコードの詳細は、API Gatewayのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "documentJson": "{\n  \"swagger\" : \"2.0\",\n  \"info\" : {\n    \"description\" : \"<br/>https://***ksk9***.apigw.ntruss.com/api000/stage\",\n    \"version\" : \"2024-05-08T02:32:42Z\",\n    \"title\" : \"api000\"\n  },\n  \"host\" : \"***ksk9***.apigw.ntruss.com\",\n  \"basePath\" : \"/api000/stage\",\n  \"schemes\" : [ \"https\" ],\n  \"paths\" : {\n    \"/\" : {\n      \"get\" : {\n        \"tags\" : [ \"stage\" ],\n        \"description\" : \"\",\n        \"parameters\" : [ ],\n        \"responses\" : {\n          \"200\" : {\n            \"description\" : \"default\"\n          }\n        (省略) }\n  }\n}"
}

この記事は役に立ちましたか?

What's Next

Stage文書の照会

リクエスト
レスポンス