brainax

API:接入别人的服务

“Vibe coding”课程第 16 课,共 26 课。免费,有动画和小测验。

API:程序之间对话

API(应用程序接口)就是一个程序请另一个程序帮忙做事的方式。像服务员:你不用进厨房,点完单菜就送到。你的服务器发请求,服务返回数据。本课例子:给你理发师朋友做的预约网站。客人一预约,网站就自动发邮件、收定金、回答问题。

能接入什么

几乎所有有用的功能都有现成的 API。邮件:Resend 或 Brevo 帮你发“你已预约周五”。支付:Stripe 或你所在国家的本地支付服务。AI:Anthropic 或 OpenAI 的 API,让机器人回答客人。还有天气、地图、翻译。图里就是右边那个框。记得确认该服务和支付在你的国家能用。

密钥该放哪

接入流程几乎总是一样的。1)在服务上注册。2)拿到 API 密钥:给程序用的密码(见密钥那一课)。3)放进服务器的环境变量,而不是写进代码。4)服务器带着密钥去调用 API。5)前端只调用你自己的服务器。浏览器看不到密钥:就像图里那样,密钥待在服务器上。

Webhook:服务主动找你

平时是你主动打电话:你的服务器发问,服务回答。Webhook 正好相反:有事发生时,服务主动去敲你服务器的地址。例子:客人付了理发钱,支付服务发来“付款成功”的 webhook,你的服务器把这条预约标成已付款。就是图里那条虚线箭头。记得校验 webhook 的签名,确认真是那个服务发的,而不是有人恶作剧。

文档和测试模式

文档就是服务方写的 API 使用说明书。把文档链接给智能体,让它照着做,这样它瞎编得少。先用测试模式:支付服务都有沙盒环境,付款是假的,不会真的扣钱。把整条流程走一遍:预约、邮件、付款、webhook。都正常?这时再换成正式(真实)的密钥。

自测一下

  1. 支付服务的 API 密钥应该放在哪?
    正确答案: 服务器的环境变量里. 密钥在服务器上,浏览器看不到。前端请求你的服务器,再由服务器带着密钥调用 API。
  2. 什么是 webhook?
    正确答案: 有事发生时,服务主动调用你的服务器. 平时是你的服务器去问。webhook 正相反:服务主动通知你,比如“付款成功”。
  3. 接入支付应该从哪开始?
    正确答案: 从不扣真钱的测试模式开始. 在沙盒里可以随便测试整条流程,没有风险。一切正常后再换正式密钥。

← 数据库和账号登录 后台任务和定时任务 →