ACTION-447: Draft a paragraph about the HTTP issue to be integrated into the API doc

Dear Florian, Thierry, all,

Here is a proposal for the text on HTTP status codes to be used in section 4.7 of the API document, replacing the current introduction paragraph (i.e. the text before the note).

-------
This section introduces a set of status codes for the defined API to indicate the system behavior. As described in section 4.4, the status code is returned as one of the attributes of the MediaAnnotation object returned by a method call to the API.

The status codes follow the scheme of the HTTP/1.1 [HTTP11] status codes, because developers are familiar with it. This choice does not imply any specific link with HTTP, nor are the status codes used as part of the actual HTTP response. Status codes from HTTP/1.1 are used with the same semantics as in [HTTP11] whenever possible, adding specific codes when needed. These specific codes are extensions in conformance with section 6.1 of [HTTP11].
-------

Best regards,
Werner

-----------------------------------------------------------------------
  Werner Bailer
  Audiovisual Media Group
  
  DIGITAL - Institute of Information and Communication Technologies
  
  JOANNEUM RESEARCH Forschungsgesellschaft mbH
  Steyrergasse 17, A-8010 Graz, AUSTRIA
 
  phone:  +43-316-876-1218            personal fax: +43-316-876-91218             
  mobile: +43-699-1876-1218            general fax: +43-316-876-1191  
  web:    http://www.joanneum.at/digital        
  e-mail: mailto:werner.bailer@joanneum.at
-----------------------------------------------------------------------

Received on Tuesday, 11 October 2011 07:38:23 UTC