swagger.yaml

swagger: '2.0'
info:
  version: v2
  title: YourName. API
host: yourname.nulab-inc.com
basePath: /api/v2
schemes:
  - https
produces:
  - application/json
consumes:
  - application/json
tags:
  - name: me
    description: Everything about login users
  - name: nulaber
    description: EveryNulabers
parameters:
  nulab-id:
    name: nulab-id
    in: path
    description: id for NulabApps
    type: string
    required: true
paths:
  '/me/{nulab-id}':
    parameters:
      - $ref: '#/parameters/nulab-id'
    get:
      tags:
        - me
      description: Get information about a user
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Nulaber'
    post:
      tags:
        - me
      description: Update information about a user
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/Nulaber'
  '/nulabers/':
    get:
      tags:
        - nulaber
      responses:
        '200':
          description: OK
          schema:
              $ref: '#/definitions/Nulabers'
definitions:
  Nulabers:
    type: array
    items: 
      $ref: '#/definitions/Nulaber'
  Nulaber:
    type: object
    properties:
      nulab_id:
        type: string
      name:
        type: string
      descriptions:
        type: string