Media Connect Centerの概要

Prev Next

Classic/VPC環境で利用できます。

Media Connect Centerは、NAVERクラウドプラットフォームのさまざまな Mediaサービスや Object Storageと連携し、メディアファイル管理のためのグループ化からエンコード、CDNとの連携、チャンネル作成、公開まで Mediaサービス全体を1つの画面で統合管理・運用できるようにサポートする NAVERクラウドプラットフォームのサービスです。Media Connect Centerサービスは、組織、メンバー、役職、職責などを照会、設定できる APIを RESTful形式で提供します。

Media Connect Centerの共通設定

Media Connect Center APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://ncloudmcc.apigw.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • Unix Timestamp形式
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
Content-Type Required リクエストデータの形式
  • application/json
x-ncp-region_code Optional リージョンコード
  • KR: 韓国 (有効値)

レスポンス

共通レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

error

errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
error Object - エラーコードとメッセージ
error.errorCode String Required エラーコード
error.message String Required エラーメッセージ

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

コード メッセージ 説明
180000 Company does not exist 会社が見つからない
180001 Forbidden, please check the sync setting in console アクセス禁止、コンソール同期設定の確認が必要
180002 The service version does not support this function サービスバージョンがこの機能をサポートしない
180003 Unauthorized 認証失敗
180004 Upper dept external key not found 上位部署の外部キーが見つからない
180006 Upper externalKey can not be the current dept externalKey 上位部署の外部キーは現在の部署の外部キーにできない
180007 Department not found 部署が見つからない
180008 Root dept can not be updated 最上位部署は変更不可
180009 Upper dept can not be the current dept's sub dept 上位部署は現在の部署の下位部署にできない
180010 Root dept can not be deleted 最上位部署は削除不可
180011 External key exists 外部キーが既に存在
180012 Name exists 名前が既に存在
180013 Job grade not found 役職が見つからない
180015 Job position not found 職責が見つからない
180016 Service version only can create {0} users サービスバージョンでは{0}人のユーザーのみ作成可能
180017 User login ID already exist ユーザーログイン IDが既に存在
180018 Bad request 無効なリクエスト
180019 User not found ユーザーが見つからない
180020 The user does not belong to this company ユーザーがこの会社に所属していない
180021 Delete Admin not allowed 管理者の削除は許可されていない
180022 Method not allowed 許可されていないメソッド
180023 Unsupported media type サポートしないメディアタイプ
180024 Internal server error 内部サーバエラー
181001 Name is required 名前が必要
181002 Name format error 名前形式エラー
181003 External key format error 外部キー形式エラー
181004 Tel number format error 電話番号形式エラー
181005 Cell phone number format error 携帯電話番号形式エラー
181006 Locale type format error ロケールタイプ形式エラー
181007 Time zone format error タイムゾーン形式エラー
181008 User email address is required ユーザーのメールアドレスが必要
181009 User email address format error ユーザーメールアドレス形式エラー
181010 Display order is required 表示順序が必要
181011 Display order format error 表示順序形式エラー
参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

Media Connect Center API

Media Connect Centerサービスで提供する APIの説明は次の通りです。

部署

部署関連 APIの説明は次の通りです。

API 説明
部署の作成 部署を作成
部署リストの照会 部署リストを照会
部署の照会 部署の詳細情報を照会
部署の更新 部署情報を更新
部署の削除 部署を削除

役職

役職関連 APIの説明は次の通りです。

API 説明
役職の作成 役職を作成
役職リストの照会 役職リストを照会
役職の照会 役職の詳細情報を照会
役職の更新 役職情報を更新
役職の削除 役職を削除

職責

職責関連 APIの説明は次の通りです。

API 説明
職責の作成 職責を作成
職責リストの照会 職責リストを照会
職責の照会 職責の詳細情報を照会
職責の更新 職責情報を更新
職責の削除 職責を削除

メンバー

メンバー関連 APIの説明は次の通りです。

API 説明
メンバーの作成 メンバーを作成
メンバーリストの照会 メンバーリストを照会
メンバーの照会 メンバーの詳細情報を照会
メンバーの更新 メンバー情報を更新
メンバーの削除 メンバーを削除

Media Connect Center関連リソース

Media Connect Center APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。