Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Kollus CMS API


Kollus VOD API

Kollus VOD API(BETA)

Kollus LIVE API 

API Interface URI 規則


Kollus APIは以下の規則で構成されていて、今後のAPI更新に伴って下位バージョンにも安定的に対応するため、APIパスにバージョン情報が含まれています。

バージョン更新の際には、以前バージョンが完全に対応できる状態になるまで該当バージョンは持続的に対応します。

Code Block
languagejs
themeMidnight
http://[api_domain]/[major_version]/{path:[container]/[controller]/[action]}?[parameters]

  • api_domain : api.kr.kollus.com, api.jp.kollus.com ドメインはサービス地域によって変更される場合があります。
  • major_versionAPIのMajorバージョン (現在0)
  • pathapiパスです。各パスは以下のようなルールで構成されています。
  • containercontroller以前までのpath
  • controlleractionの束の単位
  • action行動(action)を意味する機能(method)です。例えば、create, edit, delete, read, index(=list)などがあります。
  • parameters : ex) api_key=443ede01f6bc021514233cea82a09aee&content_provider_key=kollus

API Message


API 規格

Code Block
languagejs
themeMidnight
json, utf8


各APIのデフォルト結果文字列はUTF8でエンコードされていてjsonフォーマットになっています。

API response structure

メッセージノード

  • errorエラーコードです。0以外はエラーです。(必須)
  • messageAPI呼び出しの結果を文字列で表示します。
  • resultAPI呼び出しが成功の場合の結果を表示します。

Success Message

Code Block
languagejs
themeMidnight
{
	"error" : 0
	, "message" : "Sucessfully created."
	, "result" : {
		"key" : "test_key"
	}
}

Fail Message

Code Block
languagejs
themeMidnight
{
	"error" : 1
	, "message" : "Failed to create."
}

API 認証方法

Kollus APIを使用する為には、Kollusシステムにて提供するAPIの中の一つに認証を行う必要があります。

Kollus API認証は以下の順で認証レベルがあります。以下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のみ使用します。