Checking MediaItem Status

A MediaItem object will not be immediately available for end-users after creating it. yospaceCDS must perform intermediate processing work on the clip before it is available. In order to determine whether the clip is ready for end-user access, you can check it status using the statusMediaItemRequest call.

It requires:

Account Name / Password
MediaItem ID
The ID that you will have received from a successful MediaItem creation.

An example status request:

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:statusMediaItemRequest
         xmlns:ns2="http://www.yospace.com/tundra/MediaItemManagement/">
    
    <username>petshow</username>
    <password>Wf</password>
    <mediaItemId>2131019</mediaItemId>

    </ns2:statusMediaItemRequest>
  </soap:Body>
</soap:Envelope>

The item status can be one of the following:

  • 0, invalid (The processing failed)
  • 1, valid (Ready for Use)
  • 2, unknown (Processing is currently in progress)

Possible status code (with descriptions) are as follows:

  • 200, OK
  • 602, BAD_CONTENT_GROUP_ID
  • 604, USER_DOES_NOT_OWN_RESOURCE
  • 601, AUTHENTICATION_FAIL
  • 599, GENERAL_ERROR

An example response:

<soap:Envelope
   xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
   
    <ns2:statusMediaItemResponse
         xmlns:ns2="http://www.yospace.com/tundra/MediaItemManagement/">
     
    <statusCode>200</statusCode>
    <statusDescription>OK</statusDescription>
    <mediaItemStateCode>1</mediaItemStateCode>
    <mediaItemStateDescription>valid</mediaItemStateDescription>
   
  </ns2:statusMediaItemResponse>
</soap:Body>