一条询盘，怎样经过 API 进入客户记录？｜晓峰

01 · 先看懂 API

给两个系统一个说得通的接口。

API 是软件向其他软件提供的调用接口，约定能做什么、需要什么输入以及怎样返回结果。Web API 常通过 HTTP 交换请求与响应，但 API 不只存在于网络中。

大白话

API 让一段程序按约定请另一段程序办事。它说明怎么交资料、怎么收结果，不是一个会自动理解所有需求的万能入口。

换一个生活里的类比

像一张明确格式的受理单：交到哪个窗口、办什么事项、哪些资料必填、怎样查询回执，都事先约好。

放回外贸场景

网页把公司、邮箱和需求交给询盘接口。接口返回线索编号后，才有依据说这次记录已建立；发送通知和后续跟进仍要分别确认。

02 · 跟着询盘走一遍

从客户提交，到系统返回结果。

表单点击提交后，页面需要把公司、邮箱、需求送入 CRM；CRM 又要明确告诉页面保存成功还是字段不合格。

不熟悉的概念可以先就地查看：前端、后端、数据库。

动手看一遍 · 本地教学演示

网页怎样把一条询盘交给客户管理系统？

可以操作，也可以重试。数据为虚构示例，不连接真实业务系统。

模拟哪种结果？本词条重点：接口约定

承担的职责浏览器输入与反馈

通信约定接口约定地址、参数、返回格式

承担的职责后端处理检查规则并办理

承担的职责数据库存储和查询记录

第 1 步 · 填写需求

填写需求

采购商输入公司、邮箱与产品需求。此时还没有提交，更没有新增数据库记录。

{
  "company": "示例采购商",
  "email": "buyer@example.com",
  "need": "了解户外家具规格"
}

01
先定义客户端提交什么、服务端返回什么。
02
在服务端校验业务规则与权限。
03
把响应转换为用户能理解的界面状态。

03 · 分清责任

接口连上了，还要看它到底完成了什么。

什么时候用

独立站、CRM、报价系统或物流工具需要互相传递资料，不能靠人工复制时。

它解决什么

它让系统按明确规则沟通，减少数据格式不一致和重复操作。

它不负责什么

API 是主动请求与响应的约定；事件发生后的主动通知通常是 Webhook。

应该能检查到的内容

请求：POST /inquiries 与字段格式
校验：必填、邮箱、重复与频率
响应：成功编号、字段错误、系统错误

04 · 常见误区

别只凭一个成功提示判断。

页面先显示“提交成功”，再异步检查是否入库，会制造虚假的业务承诺。

带回项目时，检查这一点

接口文档是否让两个独立开发者写出的请求、错误处理和测试结果一致？

05 · 做一次判断

一条询盘怎样经过 API 进入 CRM

采购商在独立站提交询盘，销售希望资料立刻进入 CRM 并收到提醒。页面显示成功，却不能证明资料已经被业务系统接收。

到微课里选一次答案、查看反馈，再写下准备带回自己项目的一句话。完成情况保存在当前浏览器。

进入配套微课 · 7 分钟