<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <title>RE: API changes in upcoming MediaSense 8.5(3) release</title>
  <link rel="alternate" href="http://developer.cisco.com/c/message_boards/find_category?p_l_id=2629775&amp;mbCategoryId=0" />
  <subtitle>RE: API changes in upcoming MediaSense 8.5(3) release</subtitle>
  <id>http://developer.cisco.com/c/message_boards/find_category?p_l_id=2629775&amp;mbCategoryId=0</id>
  <updated>2013-05-19T02:24:51Z</updated>
  <dc:date>2013-05-19T02:24:51Z</dc:date>
  <entry>
    <title>RE: The mediasense sample application is corrupted and files are deleted by</title>
    <link rel="alternate" href="http://developer.cisco.com/c/message_boards/find_message?p_l_id=2629775&amp;messageId=12486315" />
    <author>
      <name>Chris Yeo</name>
    </author>
    <id>http://developer.cisco.com/c/message_boards/find_message?p_l_id=2629775&amp;messageId=12486315</id>
    <updated>2013-02-28T17:35:12Z</updated>
    <published>2013-02-28T17:35:12Z</published>
    <summary type="html">Rico, We have updated the zip file on CDN and addressed the missing js files. Sorry for the inconvenience.</summary>
    <dc:creator>Chris Yeo</dc:creator>
    <dc:date>2013-02-28T17:35:12Z</dc:date>
  </entry>
  <entry>
    <title>RE: API changes in upcoming MediaSense 8.5(3) release</title>
    <link rel="alternate" href="http://developer.cisco.com/c/message_boards/find_message?p_l_id=2629775&amp;messageId=4479716" />
    <author>
      <name>Chris Yeo</name>
    </author>
    <id>http://developer.cisco.com/c/message_boards/find_message?p_l_id=2629775&amp;messageId=4479716</id>
    <updated>2011-09-15T04:13:25Z</updated>
    <published>2011-09-14T03:54:46Z</published>
    <summary type="html">In addition to what Ken provided, there are 2 more additional changes in 8.5(3):

[b]sessionId parameter no longer allowed with getSessions API[/b].  We have modified the getSessions API to now require the client to specify a time range within which the request will be applied.  The purpose was to apply some constraint on the number of sessions that such a request would return.  Including a sessionId parameter actually limits the number of sessions to one (or zero if not found), which makes the time range requirement extraneous.  However, adding a rule by which time range would become optional if a sessionId was specified would have made the API unnecessarily complex, especially since an alternate API is available specifically for this type of request.  As a result we have eliminated sessionId as an acceptable parameter on the getSessions API, and clients including this parameter will receive an error response.
 
Recommendation:
 
Convert all calls to getSessions which include a sessionId parameter into calls to getSessionBySessionId.
 
------------------------------------------
 
[b]Error response codes to change for some APIs[/b].  Several APIs currently return a 5xxx responseCode if the value requested is not found in the database.  This is technically incorrect.  5xxx response codes are intended to indicate that the server encountered an internal error, but in these cases it is the client who issued an invalid request.  In release 8.5(3) then, these APIs will return a 4xxx responseCode instead.
 
The specific APIs affected are:
 
- cancelJob
- deleteJob
- getJobById
- getJobResult
- getJobs
- addSessionTag
- deleteSessionTag
- deleteSessions
 
When these APIs return responseCode 5005, they will now instead return 4005.  The response message, "Failure: Cannot find value in database." will remain the same.
 
Recommendation:
 
Examine your client code for comparisons against responseCode values in the 5xxx range, and make sure they operate propertly when the responseCode value becomes 4xxx instead.
 
===============================
 
Chris Yeo,
Product Manager, MediaSense</summary>
    <dc:creator>Chris Yeo</dc:creator>
    <dc:date>2011-09-14T03:54:46Z</dc:date>
  </entry>
</feed>

