Skip to content

Instantly share code, notes, and snippets.

View nickahoy's full-sized avatar

Nicholas Bell nickahoy

  • Berlin, Germany
View GitHub Profile
@nickahoy
nickahoy / Swagger and HATEOAS
Created March 25, 2015 17:26
On representing HATEOAS APIs in Swagger
http://jsonapi.org/faq/
http://blogs.mulesoft.org/api-best-practices-hypermedia-part-3/
https://lists.w3.org/Archives/Public/public-hydra/2015Feb/0086.html
Is there a JSON Schema describing JSON API?
Not currently, no. JSON Schema cannot fully represent the semantics of JSON API, and so any such schema would be partial anyway.
swagger: '2.0'
info:
title: CMS API
description: CMS Page Metadata
version: "1.0.0"
# the domain of the service
host: brands.zalando.net
basePath: /api
schemes:
- https
=================================================
Contents
=================================================
brew doctor output 12
make output 21
console.log 188