aliss-categories-api

aliss-categories-api.yaml

swagger: '2.0'
info:
  title: "ALISS API"
  description: "HSDA Road Map Suggestion"
  contact:
    name: ALISS
    url: https://docs.aliss.org
  version: v1.2
host: www.aliss.org
basePath: /api/v4/
schemes:
- http
produces:
- application/json
paths:
  /categories/:
    get:
      summary: Categories
      description: This endpoint retrieves all categories.
      operationId: categories
      responses:
        '200':
          description: Response
          schema:
            type: array
            items:
              $ref: "#/definitions/response"
      tags:
      - Categories
definitions:
  response:
    description: 'The response structure.'
    properties:
      meta:
        description: 'metadata associated with the result.'
        type: string
      data:
        type: "array"
        description: 'collection of category objects'
        items:
          $ref: "#/definitions/categories"
    required:
      - id
      - name
  categories:
    description: 'The subcategories'
    properties:
      name:
        description: 'The name of the category.'
        type: string
      slug:
        description: 'The slug of the category.'
        type: string
      sub_categories:
        type: "array"
        description: 'collection of category objects'
        items:
          $ref: "#/definitions/categories"
    required:
      - id
      - name