knightstick

{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "go test",
      "type": "shell",
      "command": "go",
      "args": ["test", "-v"],

knightstick

/api/v1/pets:
  get:
    description: Index all Pets
    responses:
      200:
        description: OK
        schema:
          title: Pets Index
          type: object
          required: ["data"]

knightstick

{
  ...
  "attributes": {
    "name": "Bingo",
    "favourite-colour": "#0000FF"
  }
}

knightstick

title: Pet
type: object
required: ["id", "type"]
properties:
  id:
    type: string
  type:
    type: string

knightstick

{
  "id": "123",
  "type": "Pets"
}

knightstick

schema:
  title: Pets Index
  type: object
  required: ["data"]

knightstick

schema:
  title: Pets Index
  type: object
  properties:
    data:
      type: array
      items:
        title: Pet
        type: object
        properties:

knightstick

swagger: '2.0'

info:
  version: "1.0.0"
  title: JSON API Pet Store

paths:
  /api/v1/pets:
    get:
      description: Index all Pets

knightstick

swagger: '2.0'

info:
  version: "1.0.0"
  title: JSON API Pet Store

paths:
  /api/v1/pets:
    get:
      description: Index all Pets

knightstick

{
  ...
  "data": [
    {
      "type": "articles",
      "id": "1",
      ...
    },
    ...
    {