Web services and their APIs abound. Unfortunately, the vast majority are difficult to use. Reasons range from poor design, to lack of documentation, 波动性, 未解决的bug, 或者在某些情况下, 以上都是. Follow the guidance in this post to help ensure that your web API is clean, 证据确凿的, 和易于使用的. Such APIs are truly rare and are therefore much more likely to be widely adopted and used.