How to REST API

• http://cs.wikipedia.org/wiki/Representational_State_Transfer
• http://blog.mwaysolutions.com/2014/06/05/10-best-practices-for-better-restful-api/

JSON Schema

• http://www.zdrojak.cz/clanky/json-schema-praxi/

REST Metadata Formats

• http://apiblueprint.org/
• http://en.wikipedia.org/wiki/Web_Application_Description_Language
• http://en.wikipedia.org/wiki/RSDL
• http://stackoverflow.com/questions/4111646/restful-services-wsdl-equivalent
• http://apiux.com/2013/04/09/rest-metadata-formats/

Frameworks

• http://loopback.io
• https://github.com/koajs/koa#v2-alpha

Rest Api Documentation

• http://apiary.io
• http://blog.apiary.io/2014/01/09/Inspirational-Resources
• http://docs.zdrojak.apiary.io
• http://apiblueprint.org
• http://connect.zive.cz/clanky/jakub-nesetril-jak-api-a-apiary-dobyvaji-svet/sc-320-a-171531
• https://www.mashape.com/howitworks

Tools

• http://blog.mashape.com/welcoming-mockbin-to-the-mashape-family/
• https://requestb.in

Dart

• http://news.dartlang.org/2015/03/create-your-own-rest-api-with-dart.html

Django

• http://www.django-rest-framework.org

Google Cloud Endpoint

• https://github.com/GoogleCloudPlatform/appengine-endpoints-tictactoe-python

NodeJS

• http://code.tutsplus.com/tutorials/restful-api-design-with-nodejs-restify--cms-22637

CRUD

• http://python-eve.org/features.html#full-range-of-crud-operations
• http://blog.dartwatch.com/2013/06/restful-crud-apis-with-appengine-cloud.html

Update - PUT vs POST

PUT /orders/{číslo objednávky} Použije se pro editaci objednávky podle jejího čísla. HTTP metoda PUT se používá pro vložení či editaci celého objektu, pokud známe jeho identifikátor. V detailu objednávky bude jednodušší při editaci posílat rovnou celý objekt, i když změníme jen část (třeba adresu nebo počet ks daných produktů).

POST /orders/{číslo objednávky} Použije se pro částečnou editaci, v našem případě při změně stavu objednávky v přehledu. Dle konvencí je možné pro částečnou editaci použít buď výše uvedenou URL, nebo také metodu PUT, ovšem pak musí být URL třeba PUT /orders/{číslo objednávky}/status. Jednodušší je použít metodu POST a konkrétní informace o změně objektu uvést v těle požadavku místo v URL.

http://www.zdrojak.cz/clanky/tvorba-moderniho-e-shopu-sprava-objednavek/