API是否应返回含秒时间？POST请求秒数处理的RESTful设计疑问

关于API返回带00秒是否合理 #

• 完全合理。数据库统一采用hh:mm:ss格式存储是标准化的做法，用户输入hh:mm时默认补00秒是明确的业务规则，API返回完整格式能保证数据结构的一致性。前端若需展示hh:mm格式，可自行截断处理，这样后端无需维护多种时间格式的返回逻辑，能降低接口复杂度。

关于POST请求带秒时忽略是否符合RESTful设计 #

• 不建议忽略秒数。RESTful设计的核心是准确表示资源状态，如果接口允许传入带秒的时间，却悄悄丢弃秒数，会导致接口行为不透明，用户会对输入输出的不一致产生困惑。
• 更合理的处理方式：
  • 明确接口的时间格式规则：要么统一只接受hh:mm格式，自动补00秒；要么兼容hh:mm和hh:mm:ss两种格式，有秒数则存储完整值，无秒数则补00。
  • 如果业务场景确实不需要秒数，应在接口文档中明确说明，并在请求校验阶段拒绝带秒数的输入，而非静默忽略，避免歧义。

内容的提问来源于stack exchange，提问作者Anshul Gupta