Skip to end of metadata
Go to start of metadata

About

 Genus Media Upshot API allows you to get the info (actions, metadata, preview, etc.) related to a resource like a video, image, doc, etc. Here's one easy way to do it with an asynchronous HTTP (Ajax) request using jQuery.

There is no a link to Genus documentation.

API Request Details

Headers

Content-Type: application/json; charset=utf-8

Type

GET

URL

{host}%3A80/mediaupshot/services/contentEngine/json/asset/{file-id} ?wrap=true&full-results=true&repository={repository-id}

Note: The {file-id} must be the ID of the resource you are looking for. I´m not sure about the nomenclature of the {repository-id}, you need to check the value that Genus generate on your environment.

Example

http://www.mygenus.com%3A80/mediaupshot/services/contentEngine/json/asset/49c8-e7-49-54-0f9290?wrap=true&full-results=true&repository=myrespository

Response

Status Code: 200 OK

Example Response

{
    "success": true,
    "content": {
        "version": {
            "value": "",
            "uuid": "49c8-e7-49-54-0f9290",
            "is-latest": true
        },
        "access-control-list": {
            "access-control-entry": []
        },
        "allowable-actions": {
            "allowable-action": [
                {
                    "action-name": "canDelete",
                    "allowed": false
                }, {
                    "action-name": "canUpdate",
                    "allowed": false
                }, {
                    "action-name": "canUpdateMetadata",
                    "allowed": false
                }, {
                    "action-name": "canUpdateOriginal",
                    "allowed": false
                }, {
                    "action-name": "canUpdatePreview",
                    "allowed": false
                }, {
                    "action-name": "canUpdateSecurity",
                    "allowed": false
                }, {
                    "action-name": "canUpdateWorkflow",
                    "allowed": false
                }, {
                    "action-name": "canSendTo",
                    "allowed": false
                }, {
                    "action-name": "canDownloadOriginal",
                    "allowed": false
                }, {
                    "action-name": "canDownloadRenditions",
                    "allowed": false
                }, {
                    "action-name": "canAddToCollection",
                    "allowed": false
                }, {
                    "action-name": "canRemoveFromCollection",
                    "allowed": false
                }, {
                    "action-name": "canModifyOwner",
                    "allowed": false
                }
            ]
        },
        "schema": {
            "name": "D:mu:asset",
            "display-name": "Media Asset"
        },
        "metadata": [
            {
                "value": "Ready",
                "name": "Status",
                "display-name": "Status",
                "namespace": "System"
            }, {
                "value": "myvideo.wmv",
                "name": "FileName",
                "display-name": "File name",
                "namespace": "System"
            }, {
                "value": "myvideo.wmv",
                "name": "Title",
                "display-name": "Title",
                "namespace": "Core"
            }, {
                "value": "2013-01-18T13:11:07-08:00",
                "name": "ModifyDate",
                "display-name": "Last Modified Date",
                "namespace": "System"
            }, {
                "value": "s-lotuscollaboration",
                "name": "ModifyUser",
                "display-name": "Modified by",
                "namespace": "System"
            }, {
                "value": "2013-01-18T13:03:30-08:00",
                "name": "CreateDate",
                "display-name": "Creation Date",
                "namespace": "System"
            }, {
                "value": "s-lotuscollaboration",
                "name": "CreateUser",
                "display-name": "User",
                "namespace": "System"
            }, {
                "value": "26680043",
                "name": "Size",
                "display-name": "Size",
                "namespace": "System"
            }
        ],
        "previews": {
            "preview": [
                {
                    "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/thumbnail/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/Thumbnail.jpg?repository=myrespository&&status=ready&ver=49c8-e7-49-54-0f9290",
                    "type": "ThumbnailImage",
                    "uuid": "ThumbnailImage",
                    "mimetype": "image/jpeg"
                }
            ]
        },
        "uuid": "a9cde-be-02-2b-305b4c13",
        "repositoryId": "myrespository",
        "type": "Video",
        "child-links": {},
        "renditions": {
            "rendition": [
                {
                    "resource": [
                        {
                            "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/master/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/myvideo.wmv?repository=myrespository",
                            "uuid": "93c7cd6b-ff0e-4d59-8879-19a113c7e249",
                            "source-type": "Repository"
                        }
                    ],
                    "name": "master",
                    "filename": "myvideo.wmv",
                    "mimetype": "video/x-ms-wmv",
                    "is-preview": false,
                    "is-master": true,
                    "size": 17213969
                }, {
                    "resource": [
                        {
                            "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/rendition/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/mp4-h264-300/qta9cde-be-02-2b-305b4c13_h264-300.mp4?repository=myrespository",
                            "uuid": "3e3c5966-c737-4d13-996f-c729af6f3d2b",
                            "source-type": "Repository"
                        }
                    ],
                    "name": "mp4-h264-300",
                    "filename": "qta9cde-be-02-2b-305b4c13_h264-300.mp4",
                    "bitrate": 476,
                    "fps": 29.97,
                    "mimetype": "video/mpeg4",
                    "is-preview": false,
                    "is-master": false,
                    "size": 4093172,
                    "duration": 68000,
                    "width": 320,
                    "height": 240
                }, {
                    "resource": [
                        {
                            "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/rendition/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/mp4-h264-500/qta9cde-be-02-2b-305b4c13_h264-500.mp4?repository=myrespository",
                            "uuid": "43904a7f-1574-42ca-87ed-0198f8470b36",
                            "source-type": "Repository"
                        }
                    ],
                    "name": "mp4-h264-500",
                    "filename": "qta9cde-be-02-2b-305b4c13_h264-500.mp4",
                    "bitrate": 624,
                    "fps": 29.97,
                    "mimetype": "video/mpeg4",
                    "is-preview": false,
                    "is-master": false,
                    "size": 5363439,
                    "duration": 68000,
                    "width": 480,
                    "height": 360
                }
            ]
        },
        "track": [
            {
                "track-entry": [
                    {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/0/Keyframe0.jpg?repository=myrespository",
                        "offset": 0.0,
                        "index": 0
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/1/Keyframe1.jpg?repository=myrespository",
                        "offset": 2000.0,
                        "index": 1
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/2/Keyframe2.jpg?repository=myrespository",
                        "offset": 4000.0,
                        "index": 2
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/3/Keyframe3.jpg?repository=myrespository",
                        "offset": 6000.0,
                        "index": 3
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/4/Keyframe4.jpg?repository=myrespository",
                        "offset": 8000.0,
                        "index": 4
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/5/Keyframe5.jpg?repository=myrespository",
                        "offset": 10000.0,
                        "index": 5
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/6/Keyframe6.jpg?repository=myrespository",
                        "offset": 12000.0,
                        "index": 6
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/7/Keyframe7.jpg?repository=myrespository",
                        "offset": 14000.0,
                        "index": 7
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/8/Keyframe8.jpg?repository=myrespository",
                        "offset": 16000.0,
                        "index": 8
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/9/Keyframe9.jpg?repository=myrespository",
                        "offset": 18000.0,
                        "index": 9
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/10/Keyframe10.jpg?repository=myrespository",
                        "offset": 20000.0,
                        "index": 10
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/11/Keyframe11.jpg?repository=myrespository",
                        "offset": 22000.0,
                        "index": 11
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/12/Keyframe12.jpg?repository=myrespository",
                        "offset": 24000.0,
                        "index": 12
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/13/Keyframe13.jpg?repository=myrespository",
                        "offset": 26000.0,
                        "index": 13
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/14/Keyframe14.jpg?repository=myrespository",
                        "offset": 28000.0,
                        "index": 14
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/15/Keyframe15.jpg?repository=myrespository",
                        "offset": 30000.0,
                        "index": 15
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/16/Keyframe16.jpg?repository=myrespository",
                        "offset": 32000.0,
                        "index": 16
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/17/Keyframe17.jpg?repository=myrespository",
                        "offset": 34000.0,
                        "index": 17
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/18/Keyframe18.jpg?repository=myrespository",
                        "offset": 36000.0,
                        "index": 18
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/19/Keyframe19.jpg?repository=myrespository",
                        "offset": 38000.0,
                        "index": 19
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/20/Keyframe20.jpg?repository=myrespository",
                        "offset": 40000.0,
                        "index": 20
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/21/Keyframe21.jpg?repository=myrespository",
                        "offset": 42000.0,
                        "index": 21
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/22/Keyframe22.jpg?repository=myrespository",
                        "offset": 44000.0,
                        "index": 22
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/23/Keyframe23.jpg?repository=myrespository",
                        "offset": 46000.0,
                        "index": 23
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/24/Keyframe24.jpg?repository=myrespository",
                        "offset": 48000.0,
                        "index": 24
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/25/Keyframe25.jpg?repository=myrespository",
                        "offset": 50000.0,
                        "index": 25
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/26/Keyframe26.jpg?repository=myrespository",
                        "offset": 52000.0,
                        "index": 26
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/27/Keyframe27.jpg?repository=myrespository",
                        "offset": 54000.0,
                        "index": 27
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/49c8-e7-49-54-0f9290/28/Keyframe28.jpg?repository=myrespository",
                        "offset": 56000.0,
                        "index": 28
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/29/Keyframe29.jpg?repository=myrespository",
                        "offset": 58000.0,
                        "index": 29
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/30/Keyframe30.jpg?repository=myrespository",
                        "offset": 60000.0,
                        "index": 30
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/31/Keyframe31.jpg?repository=myrespository",
                        "offset": 62000.0,
                        "index": 31
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/32/Keyframe32.jpg?repository=myrespository",
                        "offset": 64000.0,
                        "index": 32
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/33/Keyframe33.jpg?repository=myrespository",
                        "offset": 66000.0,
                        "index": 33
                    }, {
                        "value": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframe/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290/34/Keyframe34.jpg?repository=myrespository",
                        "offset": 68000.0,
                        "index": 34
                    }
                ],
                "type": "Keyframe",
                "source-type": "Repository",
                "source": "http://mygenus.com/mediaupshot/myservices/contentEngine/keyframes/a9cde-be-02-2b-305b4c13/4940c1c8-ea77-46b9-8854-0f6347d69290?repository=myrespository"
            }
        ],
        "status": {
            "value": "",
            "uuid": "a9cde-be-02-2b-305b4c13",
            "name": "Ready",
            "display-name": "Ready",
            "need-update": false
        }
    }
}
Example using jQuery

 $.ajax({
    url : "http://www.mygenus.com%3A80/mediaupshot/services/contentEngine/json/asset/49c8-e7-49-54-0f9290?wrap=true&full-results=true&repository=myrespository",
    type : "GET",
    async : true,
    contentType : "application/json; charset=utf-8",
    statusCode : {
        200 : function(json) {
            console.log("info");
        }
    }
});

Note:  console.log() can throw errors in IE, they are there for illustrative purposes only and should be changed as required.

About the author

Enterprise Web Developer
Joaquin is an Enterprise Web Developer at Base22 with over seven years of experience designing and developing web solutions for enterprise clients. He is a well rounded web developer with skills building interfaces in IBM WebSphere Portal and WCM, IBM Connections, and many others. He is an Oracle Certified Java Developer and a Microsoft Certified Visual Studio Developer. He blogs at http://j-arellano.com