Kollus CMS API

API Interface URI 규칙

Kollus API는 아래와 같은 규칙을 갖도록 구성었으며, 향후 API의 업그레이드 시에도 하위 버전의 안정적인 버전 지원을 위해 API 경로에 버전을 포함하고 있습니다.

버전의 업그레이드가 진행될 때 이전 버전의 전체 지원이 제한되지 않을 때 까지 해당 버전은 지속적으로 지원될 것 입니다.

http://[api_domain]/[major_version]/{path:[container]/[controller]/[action]}?[parameters]

api_domain : api.kr.kollus.com, api.jp.kollus.com 해당 도메인은 서비스 지역에 따라 변경될 수 있습니다.
major_version : API의 Major 버젼입니다. 현재 0 입니다.
path : api 경로 입니다. 각 경로는 아래와 같은 규칙을 갖습니다.
container : controller 이전까지의 path
controller : action의 묶음 단위
action : 행위(action)를 뜻하는 기능(method)이다. 예를 들자면, create, edit, delete, read, index(=list)
parameters : ex) api_key=443ede01f6bc021514233cea82a09aee&content_provider_key=kollus

json, utf8

각 API의 기본 결과 문자열은 UTF8로 인코딩되어 있으며 json 포멧을 기본으로 하고 있습니다.

{
	"error" : 0
	, "message" : "Sucessfully created."
	, "result" : {
		"key" : "test_key"
	}
}

{
	"error" : 1
	, "message" : "Failed to create."
}

Kollus API를 사용하기 위해선 Kollus 시스템에서 제공하는 API 인증 중 하나의 인증을 따라야 API의 사용이 가능합니다.

Kollus API 인증은 다음의 순서로 인증 Level(레벨)이 있습니다. 아래 3가지 인증 방법들을 이용해 API를 사용할 수 있습니다.

anonymous access
해당 URI가 anonymous access이라면 자동 인증이 통과됩니다. anonymous access를 지원하는 api는 제한적으로 사용되고 있습니다.
ip base access
Kollus 시스템에 ip base 인증를 등록하여 인증처리 합니다. Kollus 시스템 관리자에게 별도 요청해야합니다.
access_token access
각 서비스 계정에 할당되어 있는 access_token(접근 토큰)로 접근합니다.