Media Connect Center の概要

Prev Next

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

Media Connect Centerは、NAVERクラウドプラットフォームの様々なメディアサービスや Object Storageと組み合わせ、メディアファイル管理のためのグループ化からエンコーディング、CDN連携、チャンネル作成、配信に至るまで、メディアバス全体を一画面で統合管理し、運用できるようにサポートする NAVERクラウドプラットフォームのサービスです。Media Connect Centerは、組織/メンバー/役職/職位などを照会および設定できる APIを提供します。HTTP方式の GET/POST/PUT/DELETEメソッドの呼び出しを介して行われます。

共通設定

Media Connect Center API URL

https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1

リクエストヘッダ

項目 必須有無 説明
x-ncp-apigw-timestamp Y 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key Y NAVERクラウドプラットフォームポータルで発行された Access Key ID値
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Y Access Key ID値と Secret Keyで暗号化した署名
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code N リージョンコード(KR)
x-ncp-region_code:KR
Content-Type Y リクエスト Body Content Typeを application/jsonに指定
Content-Type: application/json

認証ヘッダ

Media Connect Center APIを使用するためには、API Gateway認証が必要です。API Gatewayの認証関連の詳細なガイドは、NAVERクラウドプラットフォーム APIをご参照ください。

Media Connect Center APIリクエストの構成

Header
  x-ncp-apigw-timestamp:{Timestamp}
  x-ncp-iam-access-key:{Sub Account Access Key}
  x-ncp-apigw-signature-v2:{API Gateway Signature}
  Content-Type:application/json
Body
  Json Object
URL
  {API_URL}/{resource}

Media Connect Center APIのリクエスト例

curl -i -s -X POST \
-H "Content-Type:application/json" \
-H "x-ncp-iam-access-key:HrR0s91elfiXEeTSZdwj" \
-H "x-ncp-apigw-timestamp:1700201285710" \
-H "x-ncp-apigw-signature-v2:GOWtfeX5Su8r8uvCyHfgb9RGCu0CwQP//eexqzhZTc4=" \
"https://ncloudmcc.apigw.ntruss.com/ncloudmcc/v1/companies/{CompanyID}/depts/dept019" \
-d "{\"name\": \"sales\", \"sortOrd\":0}"

共通エラー

Media Connect Center APIのエラーは、HTTP状態コードとレスポンス Body内のエラーメッセージを通じて詳細情報を提供します。

HTTP状態コード

HTTP状態コード レスポンスメッセージ 説明
200 OK 成功、レスポンスデータがある場合
201 Create 作成成功、レスポンスデータがない場合
204 No Content 成功、レスポンスデータがない場合
400 Bad Request 不正なリクエストの場合
401 Unauthorized 認証失敗
403 Forbidden 権限なし
404 Not Found 不正な URLであったり、対象リソースが見つからない場合
500 Internal Server Error その他定義されていないエラー

エラーメッセージのフォーマット

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