Implement GET on root API

Registered by Martyn Taylor

Should return top level API resource.

Relevant bits from the API Spec:

API
----

An API resource is returned at the root URL (or entry point) to the API. From
here all versions and subsequent resources are discoverable.

Usage
^^^^^^

======= ============= =====================
Verb Path Response
======= ============= =====================
GET / Get the API resource
======= ============= =====================

Fields
^^^^^^^

type
    The type of this resource, i.e. api
name
    The name of the API, e,g, openstack.ironic.api
description
    Some information about this API
versions
    A link to all the versions available in this API
default_version
    A link to the default version used when no version is specified in the URL
    or in the content-type

Example
^^^^^^^^

JSON structure of an API::

  {
    "type": "api",
    "name": "openstack ironic API",
    "description": "foobar",
    "versions": {
      "links": [{
          "rel": "self",
          "href": "http://localhost:8080/api/versions/"
        }, {
          "rel": "bookmark",
          "href": "http://localhost:8080/api/versions"
        }
      ]
    },
    "default_version": {
      "id": "1.0",
      "type": "version",
      "links": [{
          "rel": "self",
          "href": "http://localhost:8080/api/versions/1.0/"
        }, {
          "rel": "bookmark",
          "href": "http://localhost:8080/api/versions/1.0/"
        }
      ]
    }
  }

Blueprint information

Status:
Complete
Approver:
aeva black
Priority:
High
Drafter:
None
Direction:
Approved
Assignee:
Lucas Alvares Gomes
Definition:
Approved
Series goal:
Accepted for havana
Implementation:
Implemented
Milestone target:
milestone icon havana-3
Started by
aeva black
Completed by
aeva black

Related branches

Sprints

Whiteboard

Gerrit topic: https://review.openstack.org/#q,topic:root-version,n,z

Addressed by: https://review.openstack.org/39702
    Implement the root and v1 entry points of the API

(?)

Work Items

Dependency tree

* Blueprints in grey have been implemented.

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.