API变更公告

公告人：刘洋

接口：请假提交

版本：随 v1.2.5 生效

日期：0000-00-00

对象：调用请假接口的网页

一、公告结论

请假提交接口的开始日期和结束日期，从 v1.2.5 起改为日历日字符串，不再接受由时间戳换算出的日期。生效时间是生产发布完成的 9月25日 22:26。调用方只有行政协同平台自己的网页，没有外部客户。网页已随同一版本发布。显示屏和导出接口不传这两个字段，无需修改。

二、字段变化

40012 的提示是「日期格式需要是日历日」。网页在选择日期后直接提交所选的那一天，不再先转成毫秒。东八区 0 点附近的「明天」会落在员工选中的那一天。预发 4 张跨日样例已经按这个格式通过。

三、兼容安排

1. 生产从 22:26 起只接受新形态。旧形态的调用会失败并提示，不会悄悄少记 1 天。
2. 已经保存的单据按更正后的日历日读出，查询接口的日期字段同样是日历日。
3. 预订接口本来就是日历日，这次公告不改预订。
4. 若有脚本仍用时间戳调用请假，应在 9月25日前改掉。刘洋检查了仓库，只有网页一处调用。

四、验证

王芳在 22:18 用网页提交了 9月26日和 9月27日两张事假，返回单号的日期与选择一致。用旧的时间戳体在预发调用，得到 40012。陈静把本公告同步给当周值班人。后续若再改请假字段，仍用同一公告格式，写明旧形态、新形态和生效的版本号。仓库里检索时间戳调用请假的结果只有网页一处，已随 v1.2.5 一起替换。刘洋在公告发出后用预发旧请求复现了 40012，响应文案与本文一致。公告同时贴在值班群，周敏在 9月26日 9:00 的站会上念了一遍日期字段的变化。