Jump to: navigation, search

Difference between revisions of "Zaqar/specs/api/next"

(Generic)
(Generic)
Line 9: Line 9:
 
* Include Client ID in claim data
 
* Include Client ID in claim data
 
* Include claim information when listing messages and retrieving individual messages
 
* Include claim information when listing messages and retrieving individual messages
 +
* List claims for a given queue
  
 
=== HTTP ===
 
=== HTTP ===

Revision as of 14:46, 17 October 2013

Marconi API - Next

Brainstorming page for API improvements. The ideas below need to be discussed with the Marconi team and the OS community. They will be turned into blueprints as appropriate.

Generic

  • Auto-generate client UUID if not given
  • Remove deprecated "partial results" semantics from message posting
  • Include Client ID in claim data
  • Include claim information when listing messages and retrieving individual messages
  • List claims for a given queue

HTTP

  • Return an href for deleting all claimed messages with a single call
  • Allow PUTing metadata when creating a queue
  • 204 vs. 200 + empty array
  • Consistency around response envelope for /messages vs /messages?ids