api-description.json

{
  "apiVersion": "1.0.0",
  "swaggerVersion": "1.2",
  "basePath": "http://node.github.dev:8000/api",
  "resourcePath": "/genres",
  "produces": [
    "application/json"
  ],
  "apis": [
    {
      "path": "/genres/",
      "operations": [
        {
          "method": "GET",
          "summary": "Get all genres",
          "nickname": "getAllGenres",
          "parameters": []
        },
        {
          "method": "POST",
          "summary": "Add a new genre",
          "nickname": "addNewGenre",
          "parameters": [
            {
              "name": "Data",
              "description": "Data of genre to be added",
              "required": true,
              "type": "string",
              "paramType": "body"
            }
          ]
        }
      ]
    },
    {
      "path": "/genres/{genre_id}",
      "operations": [
        {
          "method": "GET",
          "summary": "Get genre by ID",
          "nickname": "getGenreById",
          "parameters": [
            {
              "name": "genre_id",
              "description": "ID of genre that needs to be fetched",
              "required": true,
              "type": "string",
              "paramType": "path"
            }
          ]
        },
        {
          "method": "PUT",
          "summary": "Update a genre",
          "nickname": "updateGenre",
          "parameters": [
            {
              "name": "genre_id",
              "description": "ID of genre that needs to be updated",
              "required": true,
              "type": "string",
              "paramType": "path"
            },
            {
              "name": "Data",
              "description": "Data of genre to be updated",
              "required": true,
              "type": "string",
              "paramType": "body"
            }
          ]
        },
        {
          "method": "DELETE",
          "summary": "Delete a genre",
          "nickname": "deleteGenre",
          "parameters": [
            {
              "name": "genre_id",
              "description": "ID of genre that needs to be deleted",
              "required": true,
              "type": "string",
              "paramType": "path"
            }
          ]
        }
      ]
    }
  ]
}