API Design Notes
Last Modified: 2017-06-21
Notes about API design
API REST
Resources
- http://apistylebook.com/design/guidelines/
- Long running operations / queues http://farazdagi.com/blog/2014/rest-long-running-jobs/
- Node lib for streaming responses http://oboejs.com/why
- https://medium.com/@sheetsu.com/rest-api-for-dummies-the-store-metaphor-c9e531bcd425
- https://docs.google.com/document/d/12zgmNg9JEQOJfdoQ3it3JoL9DCNWieDrXLuaEQ9YA3I/edit# WIP spec for public gov. APIs
- Errors https://apigee.com/about/blog/technology/restful-api-design-what-about-errors
- http://apisuomi.fi/2016/12/apit-ja-tietoturva-webinaarin-tallenne/ -> https://www.youtube.com/watch?v=olBoC572Juk
- https://martinfowler.com/articles/richardsonMaturityModel.html
- http://stateless.co/hal_specification.html
Security
REST alternatives
API Gateways & Management Platforms
- http://www.apiman.io/latest/
- https://hub.docker.com/r/jatintripathi/api-gateway/
- https://hub.docker.com/_/kaazing-gateway/
- http://nordicapis.com/api-gateways-direct-microservices-architecture/
- https://www.nginx.com/solutions/api-gateway/
- https://getkong.org/about/
Tools & platforms
- https://sheetsu.com/ Generate APIs from google spreadsheets
- http://loopback.io/
- https://dev.to/raha198/restful-api-design-with-nodejs
- https://tyk.io/
- https://github.com/linkedin/rest.li
Public API listings
Dump
- http://oembed.com/
- https://en.wikipedia.org/wiki/GPS_Exchange_Format
- http://www.odata.org/
- https://github.com/difi/datahotel Generate API from static files
- http://nordicapis.com/the-api-of-me/
- https://cloudplatform.googleblog.com/2017/04/going-multi-cloud-with-Google-Cloud-Endpoints-and-AWS-Lambda.html?m=1
- https://spatialos.improbable.io/games/grpc-web-moving-past-restjson-towards-type-safe-web-apis
- https://auth0.com/blog/aspnet-core-apis-with-swagger-and-autorest/
- https://www.linkedin.com/pulse/rest-vs-rpc-soa-showdown-joshua-hartman