機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

プロバイダ・トークンの生成

post

/content/management/api/v1.1/items/{id}/versions/{version}/providerTokens

特定のバージョンのアセットの場合。

リクエスト

サポートされているメディア・タイプ

• application/json

パス・パラメータ

• id: string
  アイテムのId。
• version: string
  アイテム改訂のバージョン

ヘッダー・パラメータ

• X-Requested-With: string
  CSRF攻撃を軽減するためのカスタム・ヘッダー。

  許容値: [ "XMLHttpRequest" ]

本文()

プロバイダ・トークン・リクエストを生成するモデル・クラス

ルート・スキーマ : ProviderToken

型: object

ProviderToken

ソースを表示

• permissions(optional): array permissions
  トークンの生成に使用する権限。有効な権限は次のとおりです: 表示、ダウンロード、コントリビュートおよび管理
• provider: object Provider
  プロバイダ
• scope(optional): object scope
  許可される追加のプロパティ: additionalProperties

  トークンが生成されるターゲットを将来識別するプロバイダ固有のプロパティ
• token(optional): string
  読取り専用: true

  生成されるトークン値

{
    "type":"object",
    "required":[
        "provider"
    ],
    "properties":{
        "provider":{
            "description":"provider for which a token is to be generated",
            "$ref":"#/definitions/Provider"
        },
        "permissions":{
            "type":"array",
            "description":"permissions with which a token is to be generated; valid permissions are: view, download, contribute, and manage",
            "items":{
                "type":"string"
            }
        },
        "scope":{
            "type":"object",
            "description":"provider specific properties to future identify a target for which a token is to be generated",
            "additionalProperties":{
                "type":"object"
            }
        },
        "token":{
            "type":"string",
            "description":"generated token value",
            "readOnly":true
        }
    },
    "description":"ProviderToken"
}

ネストされたスキーマ : 許可

型: array

トークンの生成に使用する権限。有効な権限は次のとおりです: 表示、ダウンロード、コントリビュートおよび管理

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"permissions with which a token is to be generated; valid permissions are: view, download, contribute, and manage",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ : プロバイダ

型: object

プロバイダ

ソースを表示

• name: string
  プロバイダ名

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"provider name"
        }
    },
    "description":"Provider"
}

ネストされたスキーマ : scope

型: object

使用可能なその他のプロパティ

ソースを表示

• object additionalProperties

{
    "type":"object",
    "description":"provider specific properties to future identify a target for which a token is to be generated",
    "additionalProperties":{
        "type":"object"
    }
}

トークンが生成されるターゲットを将来識別するプロバイダ固有のプロパティ

ネストされたスキーマ: additionalProperties

型: object

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

OK。

本文()

ルート・スキーマ : ProviderToken

型: object

ProviderToken

ソースを表示

• permissions(optional): array permissions
  トークンの生成に使用する権限。有効な権限は次のとおりです: 表示、ダウンロード、コントリビュートおよび管理
• provider: object Provider
  プロバイダ
• scope(optional): object scope
  許可される追加のプロパティ: additionalProperties

  トークンが生成されるターゲットを将来識別するプロバイダ固有のプロパティ
• token(optional): string
  読取り専用: true

  生成されるトークン値

{
    "type":"object",
    "required":[
        "provider"
    ],
    "properties":{
        "provider":{
            "description":"provider for which a token is to be generated",
            "$ref":"#/definitions/Provider"
        },
        "permissions":{
            "type":"array",
            "description":"permissions with which a token is to be generated; valid permissions are: view, download, contribute, and manage",
            "items":{
                "type":"string"
            }
        },
        "scope":{
            "type":"object",
            "description":"provider specific properties to future identify a target for which a token is to be generated",
            "additionalProperties":{
                "type":"object"
            }
        },
        "token":{
            "type":"string",
            "description":"generated token value",
            "readOnly":true
        }
    },
    "description":"ProviderToken"
}

ネストされたスキーマ : 許可

型: array

トークンの生成に使用する権限。有効な権限は次のとおりです: 表示、ダウンロード、コントリビュートおよび管理

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"permissions with which a token is to be generated; valid permissions are: view, download, contribute, and manage",
    "items":{
        "type":"string"
    }
}

ネストされたスキーマ : プロバイダ

型: object

プロバイダ

ソースを表示

• name: string
  プロバイダ名

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"provider name"
        }
    },
    "description":"Provider"
}

ネストされたスキーマ : scope

型: object

使用可能なその他のプロパティ

ソースを表示

• object additionalProperties

{
    "type":"object",
    "description":"provider specific properties to future identify a target for which a token is to be generated",
    "additionalProperties":{
        "type":"object"
    }
}

トークンが生成されるターゲットを将来識別するプロバイダ固有のプロパティ

ネストされたスキーマ: additionalProperties

型: object

400レスポンス

不正リクエスト

403レスポンス

禁止。

404レスポンス

見つかりません。

500レスポンス

内部サーバー・エラー

トップに戻る

例

次の例は、cURLを使用してRESTリソースでPOSTリクエストを送信することで、特定のバージョンでアセットのプロバイダ・トークンを作成する方法を示しています。

curl -X POST -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/items/{id}/versions/{version}/providerTokens'

例1:

これにより、バージョン1.1でID CONTB94719ABE603404BAE0D808C59989FF9のアセットのkalturaプロバイダ・プレビュー・トークンが生成されます。

content/management/api/v1.1/items/CONTB94719ABE603404BAE0D808C59989FF9/versions/1.1/providerTokens

リクエスト・ペイロード

{
  "provider": {
    "name": "kaltura"
  },
  "permissions": [
    "view"
  ]
}    

リクエスト・ヘッダー

{
  "Content-Type": "application/json",
  "X-Requested-With": "XMLHttpRequest"
}

レスポンス本文

{
  "provider": {
    "name": "kaltura"
  },
  "permissions": [
    "view"
  ],
  "token": "djJ8MjY4ODY5MnzKkH1uN-6ud46e4G3RE67BkNdEkp2OBbrwsjXygj_nu7XJkTXB5DB1iE0XfJH1HWWe56SjbPo44GEqcu010rxAHldHtz5k_Q7aUQrYhbNDwQSAw-1OFpz90Cr8NUHUqLQsPKXYD3qBhv4ZsLCz0xQh"
}

例2:

これにより、バージョン2でID CONTB94719ABE603404BAE0D808C59989FF9のアセットのkalturaプロバイダ編集トークンが生成されます。

/content/management/api/v1.1/items/CONTB94719ABE603404BAE0D808C59989FF9/versions/2/providerTokens

リクエスト・ペイロード

{
  "provider": {
    "name": "kaltura"
  },
  "permissions": [
    "contribute"
  ]
}     

リクエスト・ヘッダー

{
  "Content-Type": "application/json",
  "X-Requested-With": "XMLHttpRequest"
}

レスポンス本文

{
  "provider": {
    "name": "kaltura"
  },
  "permissions": [
    "contribute"
  ],
  "token": "djJ8MjY4ODY5MnzCABMfHMQeonjNtPn0_ZxOWoE7a7NqVxcDTpyoqMscJEr0btm83se9df310F9Ga2qkOGOmD-EkJHVBXwQ2Hp0JZPK_Ver9z9cPiw42kh_K93_ugMCwdbh94IKHax_VLZnEKy9jl5y4FMujsNOpbRPb"
}

先頭に戻る