How to Use

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

API Message

API 규격

json, utf8

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

API response structure

메세지 노드

  • error : 에러 코드입니다. 0이 아니면 오류 입니다. (필수)
  • message : API 호출 후 성공 여부에 대한 결과 문자열을 보여 줍니다.
  • result : API 호출 성공시 결과값입니다.

Success Message

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

Fail Message

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

API 인증방법

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

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

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

Kollus 서비스 어카운트 인증 방법

  • 각 서비스 계정에 할당되어 있는 access_token(접근 토큰)을 확인합니다.
  • 접근 하려는 모든 api에 GET or POST로 access_token을 같이 보내면 서비스 계정에 관련된 API들 사용할수 있습니다.

기타 사항

  • Restful API로 GET, POST만 사용합니다.