Ez valóban idegesítő. Az az érdekes, hogy pl egy java interface, jaxb annotációkkal egy meglehetősen egzakt(*) deklaratív leírást tud adni egy REST API-ról. Ennyi erővel lehetne adni egy programnyelvtől független leírási formát is.
(* disclaimer: olyan mélységig nem ástam bele magam, hogy minden corner-case-t leellenőrizzek, de elég kevés problémás eset van. Illetve egy terület van, amitől falra tudok mászni: a teljesen custom autentikációs megoldások. Sajnos Rest API-knál valamiért elég nagy divatja van, hogy mindenki feltalálja a saját autentikációs protokollját és ezeket sajnos nem lehet deklaratív API leírással lefedni.)
---
Régóta vágyok én, az androidok mezonkincsére már!