#%Raml 0.8
title: Contacts
version: 0.1
#baseUri: http://www.rve.com/contactshelf
baseUri: https://mocksvc.mulesoft.com/mocks/d4c4356f-0508-4277-9060-00ab6dd36e9b/contactshelf
/contacts:
  get:
    description: Retrieve list of existing contacts
    responses:
      200:
        body:
          application/json:
                example: |
                  {
                    "data": [
                      {
                        "id": "1",
                        "name": "Rheik",
                        "link": "http://localhost:4567/contacts/Rheik"
                      },
                      {
                        "id": "2",
                        "name": "Paul",
                        "link": "http://localhost:4567/contacts/Paul"
                      },
                      {
                        "id": "3",
                        "name": "Emil",
                        "link": "http://localhost:4567/contacts/Emil"
                      }
                    ],
                    "success": true,
                    "status": 200
                  }
  /{name}:
    get:
      description: Retrieve a specific contact
      responses:
       200:
         body:
            application/json:
              example: |
                {
                  "data": {
                    "id": "1",
                    "name": "Rheik",
                    "link": "http://localhost:4567/contacts/Rheik"
                  },
                  "success": true,
                  "status": 200
                }
  /new:
    post:
      description: Add a new contact
      body:
        application/json:
            example: |
              {
                "data": {
                   "name": "Franz",
                   "link":  "http://localhost:4567/contacts/Franz"
                 }
              }
        responses:
          200:
            body:
              application/json:
                example: |
                   { "message": "Contact transferred correctly." }
  /{id}:
    delete:
      description: Delete a specific contact
      responses:
        200:
          body:
            application/json:
              example: |
                { "message": "Contact id = <<resourcePathName>> deleted." }
        404:
          body:
            application/json:
              example: |
                { "message": "Contact id = <<resourcePathName>> not found." }