swagger: "2.0"
info:
  description: ""
  version: "1.0.0"
  title: "Memrise course API"
  termsOfService: "http://swagger.io/terms/"
  license:
    name: "Apache 2.0"
    url: "http://www.apache.org/licenses/LICENSE-2.0.html"
host: "www.memrise.com"
basePath: "/"

schemes:
- "https"
paths:
  /courses:
    post:
      tags:
      - "courses"
      summary: "Create course"
      produces:
      - "application/json"
      parameters:
      - in: "body"
        name: "body"
        description: "Course object"
        required: true
        schema:
          items:
            $ref: "#/definitions/Course"
      responses:
        201:
          description: "Course created"
          schema:
            $ref: "#/definitions/Course"
        422:
          description: "Course name is already used"
          schema:
            $ref: "#/definitions/Error"
    get:
      tags:
      - "courses"
      summary: "Get all courses"
      produces:
      - "application/json"
      responses:
        200:
          description: "successful operation"
          schema:
            type: "array"
            items:
              $ref: "#/definitions/Course"
        404:
          description: "Course not found"
  /course/{course_name}:
    get:
      tags:
      - "course"
      summary: "Get course by name"
      produces:
      - "application/json"
      parameters:
      - name: "course_name"
        in: "path"
        required: true
        type: "string"
      responses:
        200:
          description: "successful operation"
          schema:
            $ref: "#/definitions/Course"
        404:
          description: "Course not found"
    post:
      tags:
      - "course"
      summary: "Update course by name"
      produces:
      - "application/json"
      parameters:
      - name: "course_name"
        in: "path"
        required: true
        type: "string"
      - in: "body"
        name: "body"
        description: "Updated course object"
        required: true
        schema:
          items:
            $ref: "#/definitions/Course"
      responses:
        200:
          description: "Successful operation"
          schema:
            $ref: "#/definitions/Course"
        404:
          description: "Course not found"
        422:
          description: "Course name is already used"
          schema:
            $ref: "#/definitions/Error"
    delete:
      tags:
      - "course"
      summary: "Delete course by name"
      produces:
      - "application/json"
      parameters:
      - name: "course_name"
        in: "path"
        required: true
        type: "string"
      responses:
        200:
          description: "Deleted succesfully"
          schema:
            $ref: "#/definitions/Course"
        404:
          description: "Course not found"

definitions:
  Course:
    type: "object"
    properties:
      name:
        type: "string"
      title:
        type: "string"
      levels:
        type: "array"
        items:
          $ref: "#/definitions/Level"
  Level:
    type: "object"
    properties:
      order:
        type: "integer"
        format: "int64"
      description:
        type: "string"
  Error:
    type: "object"
    properties:
      errorCode:
        type: "integer"
        format: "int64"
      message:
        type: "string"

externalDocs:
  description: "Find out more about Swagger"
  url: "http://swagger.io"