Build APIs with common standards
Keep responses clear and simple
Secure your APIs
Publish useful documentation
Use REST standards, as most cloud applications rely on REST for API data transfer. They’re well established, with many effective and widely used practices.
A developer’s ease of working with your APIs largely depends on how well-structured and user-friendly your API responses are.
Always use SSL/TLS to secure all endpoints and resources. This ensures that client-server communication remains private, and that sensitive data is encrypted and protected.
Your API documentation should list all supported versions, breaking changes, error codes, etc., as well as contain basic info.