We at Filepicker.io spend a lot of time thinking about APIs. With the release of our Version 1.0 javascript API, we thought about best practices for javascript API design, and wanted to share them so that when we use your API, it’ll be just as awesome as when you use ours.
Rules of your Javascript API
* Rule 0: Never make breaking changes to your API. Unless you must.
* Rule 1: Provide wood and nails, and a complete house for your API
* Rule 2: Have nouns, verbs, and a complete bipartite graph
* Rule 3: When dealing with APIs fail fast, or better, not at all
* Rule 4: If the API is hard to use, it’s not good enough
Your new post is loading...