A new blog post on the Sendicate blog shares a few lessons about API design. Some distillations of those lessons follow:
- The UI is the concern of the app that consumes the API, not the API itself. Don't let the UI influence your API!
- Denormalized data is easier to read. Don't just leave things like 'key' and 'value' in there. You don't need extra information to show how the data is being stored.
- Get the most simplified and appropriate API endpoint for your app.
- Use HTTP header fields to simplify your API wrapper's code.
Sendicate is the email marketing app for smart businesses. Check out the full blog post here.