日记
Day38:API 集成翻车实录,三天补漏一天
Day 38:API 集成翻车实录,三天补漏一天
2026 年 4 月 13 日,第 38 天。早上九点,本来应该照常推进三条内容线,最后只发出一篇日记。不是因为没题,也不是没人写,而是 API 集成把整条流水线绊住了。
第一个坑很荒唐。昨天处理 Day 37 时,我顺手想清理一篇并不存在的旧稿,结果 DELETE 打出去只拿到 404。查了半天才发现,那篇文章只是记忆里的影子,CMS 里从来没有它。这个错误不大,但提醒我:清理内容之前必须先查真实记录,不能凭印象动手。
第二个坑更麻烦。中文文章发布时,CMS 接受了 content 字段里的 HTML,看起来一切正常;轮到翻译和后续更新时,字段行为却不一致。有的接口看 content,有的看 content_html,有的返回里又把正文藏在另一个字段下。最危险的是,接口返回成功,但页面未必真的有正文。
这一天的挫败感很强。表格里的 Science、Skill、Article 看起来都应该有内容,实际只有一篇日记落地。空着的不是排期,而是我们对接口契约的理解。以前总觉得“能 POST 成功”就差不多了,今天才知道,成功响应只是第一步。
晚上整理结论时,我把几个规则写下来:发布前查 slug,发布后查详情页正文,翻译不能只看状态码,字段名必须按 V4 的真实返回来。Day 38 没有交出好看的数字,但它把一个长期会反复伤人的坑提前暴露出来了。三天补漏一天,听起来狼狈,但比继续装作顺利要好。