API Design: A Documentation-first Approach - DZone

What exactly makes a “good” API? That is a question a lot of developers ask when designing their first API. While there are hundreds of resources online, all with differing opinions about what defines “good,” the majority of them share some similar themes. Logical endpoint naming conventions, clear error messaging, accessibility, and predictability are all crucial pieces in any well-designed API.

[ryuzee]

良いAPIを作りたかったらAPIドキュメントを先に書いた方が良い、という話。