当报价明显偏低、对方又明确只交付设计稿、字段说明和静态页面代码,不负责部署与联调时,双方接口设计的核心不是写一份更长的文档,而是把“谁在什么条件下触发什么动作、失败后由谁接手”写成可执行的交接点。便宜本身不是问题,问题在于接口没有定义清楚,导致上线前所有模糊地带都变成追加费用或停工。
假设一个情境:你拿到三份报价,最低的供应商只交付页面文件、字段字典和一份部署说明,报价大约是另外两家的六成。此时有两种看似合理的做法。
判断依据不是“哪家便宜”,而是你方是否有人能在不追问供应商的前提下,把文档变成可运行环境。如果答案是否定的,省下的钱通常会在联调阶段以更贵的方式花出去。选择做法二时,要把陪跑写成具体动作,例如“供应商在收到接口报错清单后两个工作日内回复字段映射问题”,而不是“提供技术支持”。
只交文档的供应商最容易在三个位置留下空白:表单提交后数据去哪、登录状态怎么保持、页面里的动态区域由谁填。设计接口时,把每一项写成三列信息即可:
一个实际动作是:在验收前挑一条最完整的用户路径,从页面点击一路走到数据落库,把中间每个交接点标上负责人。做完这一步,你会发现有些所谓“文档交付”其实只覆盖了前半段,后半段的接口根本没人认领。这个结果直接影响下一步——要么补签接口陪跑,要么把这条路径从本期范围里删掉,而不是默认它会自己跑通。
如果决定采用做法二,不必要求供应商驻场。更可行的方式是在合同或订单备注里约定一份最小联调记录:每条接口至少有一次成功请求和一次故意失败的请求,记录请求参数、返回结果和处理人。故意失败可以包括字段缺失或类型错误,用来确认错误提示由谁负责。
这份记录的作用不是证明系统多稳定,而是把“文档里写了”变成“有人按文档跑过”。当供应商只交文档时,你无法从文档本身判断它是否可实施;联调记录是少数能在付款前拿到的可区分证据。若对方拒绝提供任何联调记录,只能按做法一处理,并相应下调对上线时间的预期。
低价文档交付通常不包含服务器环境、域名解析、证书配置和第三方账号申请。这些不属于页面制作,但会直接决定网站能否访问。你需要提前确认:
把这些列为自检项,而不是等供应商主动说明。自检后发现缺项,就把它折算成你方的人力成本,再和另外两家报价比较。比较时不要只看总价,要看“文档加陪跑”和“文档加自建”这两种组合各自需要你投入多少时间。时间无法量化时,至少列出需要你方动手的具体任务数量。
回到最初的问题:供应商只交文档不实施时,接口设计的关键是先把责任人定下来。没有责任人的接口,写得再细也只是参考材料。建议按以下顺序推进:确认你方是否有对接人;没有则把陪跑写入交付范围;有则把文档验收标准写成可执行的联调清单;最后再比较报价。这样做的结果是,便宜报价是否真的便宜会变得可判断——你清楚自己接过了哪些工作,也清楚哪些问题仍会回到供应商那里。若对方连字段字典和失败归属都不愿写清,那么无论报价多低,都不适合作为需要长期维护的网站项目起点。