Asset API
 | Regarding SessionToken You need to have a valid SessionToken to be able to request any method here! |
- Asset API
- Get asset information
- Get Metadata of asset
- Input Parameter
- Metadata parameters
- Output Value
- SOAP: Sample Request
- REST: Sample Request
- Sample Output
- Modify metadata of asset
- Method
- Input Parameter
- Metadata parameters
- Output Value
- SOAP: Sample Request
- REST: Sample Request
- Sample Output
- Remove Asset
- Enable/Disable Sharing of Asset(s)
Get asset information
Method
| Method Name | Available |
|---|---|
| getasset | Razuna 1.4.5 |
Input Parameter
| Parameter | Description | Type | Required | Sample Input |
|---|---|---|---|---|
| sessiontoken | A valid sessiontoken | String | yes | 54592180-7060-4D4B-BC74-2566F4B2F943 |
| assetid | The id of the asset or a list of id's (delimited with a ",") | String | yes | 108 or 108,109,etc. |
| assettype | Type of asset | String | yes | doc = Documents img = Images vid = Videos aud = Audios |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status. If the result is 0 the method was successful. | 0 |
| calledwith | The folderid you passed to this method | 1 |
| assets | For each asset an asset node is returned with information of the asset | see sample output |
| Since Razuna 1.4.6 the return also contains the "RAW" metadata fields of each asset in the node <metadata>. If you want to retrieve single metadata field you can use the dedicated getmetadata() method. |
SOAP: Sample Request
REST: Sample Request
Sample Output
Get Metadata of asset
 | The getasset() method already returns the description and the keyword value for each asset, thus this method only returns the associated XMP metadata values!
Only PDF documents and images contain additional metadata. Obviously this method only works for "doc" and "img"! |
| Method Name | Available |
|---|---|
| getmetadata | Razuna 1.4.6 |
Input Parameter
| Parameter | Description | Type | Required | Sample Input |
|---|---|---|---|---|
| sessiontoken | A valid sessiontoken | String | yes | 54592180-7060-4D4B-BC74-2566F4B2F943 |
| assetid | The id of the asset or a list of id's (delimited with a ",") | String | yes | 108 or 108,109,etc. |
| assettype | Type of asset | String | yes | doc = Documents (PDF) img = Images |
| assetmetadata | Name of metadata field to query | String | yes | headline,city,rights See the metadata field list below! |
Metadata parameters
Documents
| Metadata fields |
|---|
| author |
| rights |
| authorsposition |
| captionwriter |
| webstatement |
| rightsmarked |
Images
| Metadata fields |
|---|
| asset_type |
| subjectcode |
| creator |
| title |
| authorsposition |
| captionwriter |
| ciadrextadr |
| category |
| supplementalcategories |
| urgency |
| description |
| ciadrcity |
| ciadrctry |
| location |
| ciadrpcode |
| ciemailwork |
| ciurlwork |
| citelwork |
| intellectualgenre |
| instructions |
| source |
| usageterms |
| copyrightstatus |
| transmissionreference |
| webstatement |
| headline |
| datecreated |
| city |
| ciadrregion |
| country |
| countrycode |
| scene |
| state |
| credit |
| rights |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status. If the result is 0 the method was successful. | 0 |
| metadata | All the nodes of the chosen me metadata fiels. | "values" |
SOAP: Sample Request
REST: Sample Request
Sample Output
Modify metadata of asset
Method
| Method Name | Available |
|---|---|
| setmetadata | Razuna 1.4.4 |
Input Parameter
| Parameter | Description | Type | Required | Sample Input |
|---|---|---|---|---|
| sessiontoken | A valid sessiontoken | String | yes | 54592180-7060-4D4B-BC74-2566F4B2F943 |
| assetid | The id of the asset or a list of id's (delimited with a ",") | String | yes | 108 or 108,109,etc. |
| assettype | Type of asset | String | yes | doc = Documents img = Images vid = Videos aud = Audios |
| assetmetadata | String | yes | JSON structure of metadata See the metadata field list below |
Metadata parameters
You can pass all or any of the metadata fields in the assetmetadata field as a JSON structure. A example of passing the metadata for images would be (you need to serialize your array in order to pass it in a URL):
| Mandatory field The only mandatory field you need to include is the "lang_id_r" one. |
Videos
| Metadata fields |
|---|
| vid_keywords |
| vid_description |
| vid_title |
| lang_id_r |
Audios
| Metadata fields |
|---|
| file_keywords |
| file_desc |
| lang_id_r |
Documents
| Metadata fields |
|---|
| aud_keywords |
| aud_description |
| lang_id_r |
Images
| Metadata fields |
|---|
| img_keywords |
| img_description |
| lang_id_r |
For images you additionally have the option to define the XMP metadata values. The following fields can be used:
| Metadata fields |
|---|
| asset_type |
| subjectcode |
| creator |
| title |
| authorsposition |
| captionwriter |
| ciadrextadr |
| category |
| supplementalcategories |
| urgency |
| description |
| ciadrcity |
| ciadrctry |
| location |
| ciadrpcode |
| ciemailwork |
| ciurlwork |
| citelwork |
| intellectualgenre |
| instructions |
| source |
| usageterms |
| copyrightstatus |
| transmissionreference |
| webstatement |
| headline |
| datecreated |
| city |
| ciadrregion |
| country |
| countrycode |
| scene |
| state |
| credit |
| rights |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status. If the result is 0 the method was successful. | 0 |
SOAP: Sample Request
REST: Sample Request
Sample Output
Remove Asset
Method
| Method Name | Available |
|---|---|
| remove | Razuna 1.4.6 |
Input Parameter
| Parameter | Description | Type | Required | Sample Input |
|---|---|---|---|---|
| sessiontoken | A valid sessiontoken | String | yes | 54592180-7060-4D4B-BC74-2566F4B2F943 |
| assetid | The id of the asset or a list of id's (delimited with a ",") | String | yes | 108 or 108,109,etc. |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status. If the result is 0 the method was successful. | 0 |
| message | Message of the result | see sample output |
SOAP: Sample Request
REST: Sample Request
Sample Output
Enable/Disable Sharing of Asset(s)
Method
| Method Name | Available |
|---|---|
| setshared | Razuna 1.3.5 |
Input Parameter
| Parameter | Description | Type | Required | Sample Input |
|---|---|---|---|---|
| sessiontoken | A valid sessiontoken | String | yes | 54592180-7060-4D4B-BC74-2566F4B2F943 |
| assetid | The id of the asset or a list of id's (delimited with a ",") | String | yes | 108 or 108,109,etc. |
| assettype | Type of asset | String | yes | doc = Documents img = Images vid = Videos aud = Audios |
| activate | Enable or disable asset | Number | yes | 1 = enable 0 = disable |
Output Value
| Name | Description | Sample Output |
|---|---|---|
| Response | A result code with the status. If the result is 0 the method was successful. | 0 |
SOAP: Sample Request
REST: Sample Request
Sample Output
Labels:
None
Add Comment