Asset API
- Asset API
- Get asset information
- Method
- Input Parameter
- Output Value
- SOAP: Sample Request
- REST: Sample Request
- Sample Output
- 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
- Method
- Input Parameter
- Output Value
- SOAP: Sample Request
- REST: Sample Request
- Sample Output
- Enable/Disable Sharing of Asset(s)
- Method
- Input Parameter
- Output Value
- SOAP: Sample Request
- REST: Sample Request
- Sample Output
- Get asset information
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 |
assettype |
Type of asset |
String |
yes |
doc = Documents |
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 . 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 |
assettype |
Type of asset |
String |
yes |
doc = Documents (PDF) |
assetmetadata |
Name of metadata field to query |
String |
yes |
headline,city,rights |
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 |
assettype |
Type of asset |
String |
yes |
doc = Documents |
assetmetadata |
|
String |
yes |
JSON structure of metadata |
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 |
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 |
assettype |
Type of asset |
String |
yes |
doc = Documents |
activate |
Enable or disable asset |
Number |
yes |
1 = enable |
Output Value
Name |
Description |
Sample Output |
---|---|---|
Response |
A result code with the status. If the result is 0 the method was successful. |
0 |