モデルのプレビュー

Prev Next

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

作成したボディモデルの動作を予め確認します。

リクエスト

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

メソッド URI
POST /products/{product-id}/apis/{api-id}/models/preview

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
product-id String Required APIが属する Product ID
api-id String Required モデルをプレビューする対象の API ID

リクエスト構文

リクエスト構文は次の通りです。

{
  "modelId" : "modelId",
  "modelSchema" : "modelSchema"
}

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
modelId String Optional 対象モデルの ID
  • モデルの照会を通じて確認
  • modelSchema String Required 定義したモデルのスキーマ
  • モデルの照会を通じて確認
  • リクエスト例

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

    curl --location --request POST 'https://apigateway.apigw.ntruss.com/api/v1/products/********o9/apis/cvcohvd2xj/models/preview' \
    --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 '{
      "modelId" : "qw33h0i33i",
      "modelSchema" : "{\n  \"type\": \"object\",\n  \"properties\": {\n    \"apiKeyDescription\": { \"type\": \"string\" },\n    \"apiKeyId\": { \"type\": \"string\" },\n    \"apiKeyName\": { \"type\": \"string\" }\n  },\n  \"description\": \"model description\"\n}\n"
    }'
    

    レスポンス

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

    レスポンス構文

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

    {
      "modelSchema" : {}
    }
    

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

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

    レスポンス例

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

    {
        "modelSchema": {
            "type": "object",
            "properties": {
                "apiKeyDescription": {
                    "type": "string"
                },
                "apiKeyId": {
                    "type": "string"
                },
                "apiKeyName": {
                    "type": "string"
                }
            },
            "description": "model description"
        }
    }