API
    • PDF

    API

    • PDF

    Article Summary

    API 복사

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/clone
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "apiName" : "apiName",
      "apiDescription" : "apiDescription",
      "originApiId" : "originApiId"
    }
    

    응답 코드

    • 201

    응답 바디

    {
      "api" : {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      }
    }
    

    API 생성

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "apiName" : "apiName",
      "apiDescription" : "apiDescription"
    }
    

    응답 코드

    • 201

    응답 바디

    {
      "api" : {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      }
    }
    

    API 삭제

    URL

    DELETE https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    apiIdpathYStringApi Id
    길이(최대/최소): 0/10

    요청 바디

    • 없음

    응답 코드

    • 204

    응답 바디

    • 없음

    API 배포

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/deploy
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    apiIdpathYStringApi Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "deploymentDescription" : "deploymentDescription",
      "stageId" : "stageId"
    }
    

    응답 코드

    • 200

    응답 바디

    • 없음

    API 조회

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    offsetquery stringNLongOffset
    최소: 0
    최대: 9,223,372,036,854,775,807
    limitquery stringNLongLimit
    최소: 1
    최대: 9,223,372,036,854,775,807
    withStagequery stringNBooleanWith Stage
    apiNamequery stringNStringApi Name
    길이(최대/최소): 0/20
    hasStagequery stringNBooleanHas Stage
    hasStageNotAssociatedWithUsagePlanIdquery stringNStringHas Stage Not Associated With Usage Plan Id

    요청 바디

    - 없음

    응답 코드

    • 200

    응답 바디

    {
      "total" : 0,
      "apis" : [ {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      } ]
    }
    

    API 조회

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/filter
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10

    요청 바디

    • 없음

    응답 코드

    • 200

    응답 바디

    {
      "total" : 0,
      "apis" : [ {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      } ]
    }
    

    API 조회

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    apiIdpathYStringApi Id
    길이(최대/최소): 0/10

    요청 바디

    • 없음

    응답 코드

    • 200

    응답 바디

    {
      "api" : {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      }
    }
    

    API 검색

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/infos
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    offsetquery stringNLongOffset
    최소: 0
    최대: 9,223,372,036,854,775,807
    limitquery stringNLongLimit
    최소: 1
    최대: 9,223,372,036,854,775,807
    withStagequery stringNBooleanWith Stage
    apiNamequery stringNStringApi Name
    길이(최대/최소): 0/20
    hasStagequery stringNBooleanHas Stage
    hasStageNotAssociatedWithUsagePlanIdquery stringNStringHas Stage Not Associated With Usage Plan Id

    요청 바디

    • 없음

    응답 코드

    • 200

    응답 바디

    {
      "total" : 0,
      "apis" : [ {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      } ]
    }
    

    Swagger로부터 데이터 가져오기

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/import
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "apiName" : "apiName",
      "apiDescription" : "apiDescription",
      "importValidateType" : "FAIL_ON_WARN",
      "swagger" : "swagger"
    }
    

    응답 코드

    • 200

    응답 바디

    {
      "errorMessages" : [ "errorMessages" ],
      "warnMessages" : [ "warnMessages" ],
      "success" : true,
      "api" : {
        "apiName" : "apiName",
        "domainCode" : "domainCode",
        "productId" : "productId",
        "modifier" : "modifier",
        "permission" : "permission",
        "isDeleted" : true,
        "modTime" : "2000-01-23T04:56:07.000+00:00",
        "stages" : [ {
          "stageName" : "stageName",
          "isPublished" : true,
          "apiId" : "apiId",
          "stageId" : "stageId"
        } ],
        "tenantId" : "tenantId",
        "apiDescription" : "apiDescription",
        "disabled" : true,
        "apiId" : "apiId",
        "actionName" : "actionName"
      }
    }
    

    API 수정

    URL

    PATCH https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    apiIdpathYStringApi Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "apiDescription" : "apiDescription"
    }
    

    응답 코드

    • 204

    응답 바디

    • 없음

    API 게시

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/products/{product-id}/apis/{api-id}/publish
    

    요청 파라미터

    이름위치필수여부타입설명
    productIdpathYStringProduct Id
    길이(최대/최소): 0/10
    apiIdpathYStringApi Id
    길이(최대/최소): 0/10

    요청 바디

    {
      "stages" : [ {
        "isPublished" : true,
        "stageId" : "stageId"
      } ]
    }
    

    응답 코드

    • 204

    응답 바디

    • 없음

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.