Прекарах последните няколко дни, опитвайки се да разбера дали трябва да използвам api blueprint, RAML или swagger. Изглежда, че swagger има най-голямата общност, но колкото по-внимателно се вглеждам, толкова повече усещам, че му липсва много...

Опитвам се да използвам apiary.io, за да документирам API, базиран на JSON-RPC. Мога да форматирам страниците, но конзолата просто не работи. С JSON-RPC обикновено имате само 1 URI, такъв е случаят с нашия API. Поради това, когато се опитва да...

Чудех се дали е възможно да се включат квадратни скоби в името на параметъра, което е начинът, по който Rails групира параметрите. Например: + Parameters + person[age] (string) ... Person's age Точно сега, ако включа квадратната...