Про то, как надо делать API

Попалась отличная статья(перевод) на хабре, о том, как надо делать REST API: Разработка web API (перевод)
Жаль, что я не прочитал её на несколько месяцев раньше, когда я переделывал некоторую функциональность на одном из проектов. Хотя приятно, что до некоторых идей получилось додуматься самостоятельно :)

Из интро выяснилось откуда ноги растут: "Это краткий перевод основных тезисов из брошюры «Web API Design. Crafting Interfaces that Developers Love» Брайана Маллоя из компании Apigee Labs"

В общем, читать и перечитывать, пока в голове не застрянет накрепко :)