说说如何设计一个良好的 API

应语义清晰、规范统一、接口简洁、参数合理、返回结构标准、错误码明确、文档完善、支持版本控制和幂等性。