apiCategory

API 카테고리는 API를 그룹화 하여 관리하기 위해서 사용하며, 하위 API에 대한 공통 설정을 정의할 수 있다.

예를들어, API 카테고리에 권한을 설정하면, 하위 API는 모두 같은 해당 권한을 일차적으로 체크하게 된다.

{{protocol}}://{{hostname}}:{{port}}/{{apiType}}/{{apiCategory}}/{{api}}

 

API Category 속성

pid

valueType

description

pid

valueType

description

id

STRING

생성할 apiCategory의 ID이며 API 호출 URL의 2번째 Path에 사용

categoryName

STRING

apiCategory의 이름

apiType

CODE

API 유형

apiAuthority

REFERENCES

권한

dateFormat

STRING

dateFormat 설정(하위의 api에 공통으로 적용)

yyyy-MM-dd HH:mm:ss

fileUrlFormat

JSON

API에 리턴되는 file URL의 Prefix 설정(하위의 api에 공통으로 적용)

commonParameters

CHILDREN

공통 Parameter 정의(하위의 api에 공통으로 적용)

"commonParameters": [ { "parameter": "_siteId", "required": true }, { "parameter": "_deviceType", "required": false } ]

commonResponse

CHILDREN

하위 API Config에서 사용할 기본 Response 정의

"commonResponse": [ { "field": "time", "type": "field", "value": "{{:sysdate}}" } ]

 

apiType

apiAuthority

 

fileUrlFormat

API에 리턴되는 file URL의 Prefix 설정(하위의 api에 공통으로 적용)

"fileUrlFormat": { "default": "{{:getEnvValue('core.cluster.api-url-prefix')}}" },

getEnvValue

  • Profile에 따라 환경 변수를 치환하여 결과를 반환한다.

API Response :

 

API Response :

 

 

커스텀 가능

apiCategory

  • "video" 추가

application.yml

  • core.cluster.wowza-url-prefix 설정

propertyType.json

  • "fileHandler": "video", 설정

 

VideoFileRepository.java

  • FileRepository 추가. implements FileRepository

  • 명명규칙

    • {{fileHandler}}FileRepository.java

 

API Response :

mainImageFile 는 default fileHandler

fileValue 는 video fileHandler

 

 

 

 

설정 예