Как я перестал волноваться и стал отдавать метаданные restful API
Если вы делаете публичный API, то скорее всего сталкивались с проблемой его документации. Большие компании делают специальные порталы для разработчиков, где можно почитать и обсудить документацию, или скачать библиотеку-клиент для вашего любимого языка программирования.
Поддержка такого ресурса (особенно в условиях, когда API активное развивается) достаточно трудозатратное дело. При изменениях, приходится синхронизировать документацию с фактической реализацией и это напрягает. Синхронизация состоит из: Проверки, что вся существующая функциональность описана в документации
Проверки, что всё описанное работает как заявлено в документации
Читать дальше →
