编写好看的项目接口程序需要遵循一些最佳实践和设计原则。以下是一些关键点：
明确接口目标和范围
在编写接口设计文档时，首先需要明确接口的目标和范围。明确接口的目标可以帮助您确定接口所需的功能和特性，范围则可以帮助您确定接口需要支持的数据类型、请求和响应格式等。
使用清晰的接口命名
良好的接口命名可以让其他开发人员轻松理解和调用接口。命名应该简洁明了、易于理解，并且与接口功能和用途相关。
确定接口请求和响应格式
接口请求和响应格式包括数据类型、编码方式、传输协议等，这些参数将直接影响接口的性能和用户体验。确定接口请求和响应格式的过程中，需要尽可能考虑到不同场景下的使用情况，以便满足各种情况下的需求。
使用易于理解的参数名
参数名是接口中非常重要的一部分，它们应该简单、明了，并且与请求的数据类型和含义相关。在编写文档时，需要使用易于理解的参数名，以便其他开发人员更好地理解接口，编写出更加高效、易于维护的代码。
定义接口返回状态码
定义接口返回状态码可以帮助接口使用者更好地理解和处理接口返回结果，避免不必要的错误。状态码应该简洁、易于识别，并且能够清晰地表达出接口返回的结果和状态。
提供详细的接口描述
为了让其他开发人员更好地理解接口的功能和用途，接口设计文档需要提供详细的接口描述信息。这些信息包括接口的作用、使用方法、参数说明、示例代码等。
明确接口性能指标
良好的接口性能可以提高用户体验，使应用程序更加流畅和稳定。在接口设计时，需要考虑到性能指标，如响应时间、并发处理能力等。
参数校验
即使前端做了非空、规范性校验，服务端参数仍然是非常必要的。在接口程序中，需要对输入参数进行严格的校验，确保数据的合法性和安全性。
统一返回值
一个服务一套统一的数据返回结果和传参规范。返回值应该包含调用接口状态信息，返回数据格式最好使用JSON。
统一异常封装
系统报错友好提示，避免暴露出sql异常的信息给调用方。可以对系统异常进行统一封装，提供友好的错误信息。
请求日志
记录系统产生的日志，方便快速定位分析问题。在关键的方法结束前，可以打印日志，方便定位问题。
幂等设计
对于一些涉及到数据一致性的接口一定要做好幂等设计，防止数据出现重复问题。
限制记录条数
对于对外提供的批量接口，一定限制请求的记录条数，避免大量数据请求影响系统性能。
压测
上线前必须对API接口做压力测试，知道各个接口的QPS情况，以便预估需要部署多少服务器节点，保证接口的稳定性。
异步处理
如果同步处理业务耗时会非常长，可以考虑改成异步处理，提升API接口的性能。
数据脱敏
对于关系到业务中用户的敏感数据要进行脱敏处理，保护用户隐私。
签名认证
对外提供的接口要做签名认证，认证不通过的请求不允许访问接口，确保接口的安全性。
代码规范
遵循《阿里巴巴Java开发手册》等代码规范，保持代码的一致性和可读性。
使用工具
可以使用一些工具如Swagger、Postman等来辅助接口的编写和测试，自动生成接口文档，方便前后端对接。
通过遵循以上原则和实践，可以编写出既美观又实用的项目接口程序。