|
|
(One intermediate revision by one other user not shown) |
Line 1: |
Line 1: |
− | '''Get Home Document'''
| |
| | | |
− | Template: GET /v1
| |
− |
| |
− | Normal Response Code(s): 200
| |
− |
| |
− | This operation gets the home document. The entire API is discoverable from a single starting point - the home document. You do not need to know any more than this one URI in order to explore the entire API. This document is cacheable. The home document lets you write clients using a "follow-your-nose" style so clients do not have to construct their own URLs. You can click through and view the JSON doc in your browser.
| |
− |
| |
− | See also: http://tools.ietf.org/html/draft-nottingham-json-home-02
| |
− |
| |
− | Example Request:
| |
− |
| |
− | GET /v1 HTTP/1.1
| |
− | Host: marconi.example.com
| |
− |
| |
− | ....
| |
− |
| |
− | Example Response:
| |
− |
| |
− | HTTP/1.0 200 OK
| |
− |
| |
− | Cache-Control: max-age=86400
| |
− | Content-Length: 4345
| |
− | Content-Type: application/json-home
| |
− | Date: Tue, 06 Aug 2013 16:31:48 GMT
| |
− | Server: WSGIServer/0.1 Python/2.7.3
| |
− |
| |
− | {
| |
− | "resources": {
| |
− | "http://docs.openstack-marconi.org/rel/queues": {
| |
− | "href-template": "/queues{?marker,limit,detailed}",
| |
− | "href-vars": {
| |
− | "marker": "http://docs.openstack-marconi.org/param/marker",
| |
− | "detailed": "http://docs.openstack-marconi.org/param/detailed",
| |
− | "limit": "http://docs.openstack-marconi.org/param/queue_limit"
| |
− | },
| |
− | "hints": {
| |
− | "allow": [
| |
− | "GET"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/queue-stats": {
| |
− | "href-template": "/queues/{queue_name}/stats",
| |
− | "href-vars": {
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name"
| |
− | },
| |
− | "hints": {
| |
− | "allow": [
| |
− | "GET"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/post-messages": {
| |
− | "href-template": "/v1/queues/{queue_name}/messages",
| |
− | "href-vars": {
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name"
| |
− | },
| |
− | "hints": {
| |
− | "accept-post": [
| |
− | "application/json"
| |
− | ],
| |
− | "allow": [
| |
− | "POST"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/queue": {
| |
− | "href-template": "/queues/{queue_name}",
| |
− | "href-vars": {
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name"
| |
− | },
| |
− | "hints": {
| |
− | "allow": [
| |
− | "PUT",
| |
− | "DELETE"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/messages": {
| |
− | "href-template": "/queues/{queue_name}/messages{?marker,limit,echo,include_claimed}",
| |
− | "href-vars": {
| |
− | "marker": "http://docs.openstack-marconi.org/param/marker",
| |
− | "include_claimed": "http://docs.openstack-marconi.org/param/include_claimed",
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name",
| |
− | "limit": "http://docs.openstack-marconi.org/param/messages_limit",
| |
− | "echo": "http://docs.openstack-marconi.org/param/echo"
| |
− | },
| |
− | "hints": {
| |
− | "allow": [
| |
− | "GET"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/claim": {
| |
− | "href-template": "/v1/queues/{queue_name}/claims{?limit}",
| |
− | "href-vars": {
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name",
| |
− | "limit": "http://docs.openstack-marconi.org/param/claim_limit"
| |
− | },
| |
− | "hints": {
| |
− | "accept-post": [
| |
− | "application/json"
| |
− | ],
| |
− | "allow": [
| |
− | "POST"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/health": {
| |
− | "href": "/health",
| |
− | "hints": {
| |
− | "allow": [
| |
− | "GET",
| |
− | "HEAD"
| |
− | ]
| |
− | }
| |
− | },
| |
− | "http://docs.openstack-marconi.org/rel/queue-metadata": {
| |
− | "href-template": "/queues/{queue_name}/metadata",
| |
− | "href-vars": {
| |
− | "queue_name": "http://docs.openstack-marconi.org/param/queue_name"
| |
− | },
| |
− | "hints": {
| |
− | "allow": [
| |
− | "GET",
| |
− | "PUT"
| |
− | ],
| |
− | "formats": {
| |
− | "application/json": {}
| |
− | }
| |
− | }
| |
− | }
| |
− | }
| |
− | }
| |