As with other types of interface design, the best way to write a good api is to get frequent feedback from the intended users.<p>Liberal application of the WTF test is critical[1].<p>As the author of the api, you yourself will be too close to it to judge fairly. Poorly named functions and over-complicated architecture will appear perfectly reasonable to you if you don&#x27;t seek outside opinions.<p>1: <a href="http:&#x2F;&#x2F;commadot.com&#x2F;wp-content&#x2F;uploads&#x2F;2009&#x2F;02&#x2F;wtf.png" rel="nofollow">http:&#x2F;&#x2F;commadot.com&#x2F;wp-content&#x2F;uploads&#x2F;2009&#x2F;02&#x2F;wtf.png</a>