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)からの経過時間(ミリ秒)
|
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 | リクエストデータの形式
|
x-ncp-region_code |
Optional | リージョンコード
|
レスポンス
共通レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
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についてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。
- Media Connect Center APIの使用方法
- 署名(シグネチャー)の作成: リクエストヘッダに追加する署名の作成方法
- Sub Accountご利用ガイド: リクエストヘッダに追加する Access Keyの発行方法
- Ncloudの共通レスポンスステータスコード: Media Connect Centerサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Media Connect Centerサービスの使用方法
- Media Connect Centerご利用ガイド: NAVERクラウドプラットフォームコンソールで Media Connect Centerサービスを使用する方法
- Ncloud使用環境ガイド: VPC、Classic環境とサポート有無に関するガイド
- 料金の紹介、特徴、詳細機能: Media Connect Centerサービスの料金体系、特長、詳細機能のサマリー
- サービスのお知らせ: Media Connect Centerサービスに関するお知らせ
- よくある質問: Media Connect Centerサービスに関するよくあるご質問
- お問い合わせ: APIガイドだけでは不明な点が解消されない場合、直接問い合わせ