File: raml/songs.raml

#%RAML 0.8
 
title: World Music API
baseUri: http://example.api.com/{version}
version: v1
traits:
  - paged:
      queryParameters:
        pages:
          description: The number of pages to return
          type: number
  - secured: !include raml/githubrepo.raml
/songs:
  is: [ paged, secured ]
  get:
    queryParameters:
      genre:
        description: filter the songs by genre
  post:
  /{songId}:
    get:
      responses:
        200:
          body:
            application/json:
              schema: !include raml/githubrepo.raml
            application/xml: !include raml/githubrepo.raml
    delete:
      description: |
        This method will *delete* an **individual song**