EN

API 点菜台

API 就是一份菜单——一张列着「你可以问另一台电脑要哪些东西」的清单。来点一道吧。🍽️

把整个互联网想象成一堆小小的厨房(服务器),它们会替你「做」出数据来。你不能直接冲进去自己炒——而是读它们的菜单(也就是 API),然后点单。点下面任意一道菜,把你的订单发出去。👇

📋 菜单 —— 4 道你可以点的菜

每一道都是一个 API 接口(endpoint):这个厨房会做的某一样东西。

你的订单
🍽️

从上面的菜单里挑一道菜,就能下单啦。

🍴 这家餐厅,逐一对照
🙋
你 = 顾客。由你来决定要点什么。
📋
API = 菜单。它列着你能点的所有东西。
🍳
服务器 = 厨房。它查一查你的订单,然后做出来。
🍽️
JSON = 上桌的菜。数据,以整整齐齐、贴好标签的格式端给你。

GET 只是「问一问」——它只是取一份数据的副本回来,绝不会改动、删除或弄坏厨房里的任何东西。放心大胆地试。😌

🔑 还有一件事。有些菜单需要一把钥匙——API key 就像一个密码,用来证明你有资格点单。千万不要把真的 API key 贴进公开的 GitHub 仓库。机器人会在几分钟之内扫遍互联网,找到泄露的钥匙,然后把你的账单刷爆。钥匙要藏好。🤫
这就是那个大道理。 一个 API 就是一份菜单,列着「这台电脑愿意替另一台电脑取来的东西」。你发出一个 GET 请求——其实就是礼貌地问一句「请把这个给我」——它就回你一份 JSON: 一种整整齐齐、贴好标签的格式,每一种编程语言读起来都一模一样。 { } 是一个对象(一个贴好标签的盒子,里面装着一对对的 key:value),[ ] 是一个列表, "文字" 待在引号里,数字不用引号,而「是/否」这种答案就是 true / false。 这正是你教 AI 学会全新本领的办法:让它从全世界的菜单里点菜。🌍