后面 60 天你几乎每天都在做同一件事：把数据打包成请求发出去、把返回的结果解析出来用。RAG 要调 embedding API，工具调用要调外部服务 API，部署后你的 Agent 本身也是一个 API。所以今天是整条路线的地基——它不难，但绕不过去。

一次请求里主要装 4 样东西：

• 方法(Method)：你想干嘛（取数据？提交数据？）——下节讲；
• URL(网址)：找哪家店、哪张桌 https://api.example.com/weather?city=北京；
• 请求头(Headers)：附带说明，比如"我是谁"（身份/API Key）、"我要 JSON 格式"；
• 请求体(Body)：要提交的具体内容（点单的详细内容），只有 POST 这类才有。

新手 90% 的时间只会用到 GET 和 POST。规律：只是"要点信息"用 GET，"提交内容让服务器处理"用 POST。调大模型属于后者——你把问题(内容)提交上去让它生成回答，所以是 POST。

JSON 只有几种积木：对象 {...}（键值对，像字典）、数组 [...]（列表）、字符串 "..."、数字、true/false、null。看一眼就懂：

{
  "city": "北京",
  "temperature": 28,
  "is_sunny": true,
  "forecast": ["晴", "多云", "小雨"]
}

Python 里用内置的 json 模块互转（不过下一节的 requests 会帮你自动做）：

import json                      # Python 自带，不用安装

# 字符串(JSON) → Python 字典，叫“解析/反序列化”
s = '{"city": "北京", "temp": 28}'
data = json.loads(s)             # loads = load string
print(data["city"])             # 北京   ← 像字典一样取值

# Python 字典 → 字符串(JSON)，叫“序列化”，准备发出去
d = {"city": "上海", "temp": 30}
print(json.dumps(d, ensure_ascii=False))  # {"city": "上海", "temp": 30}
# ensure_ascii=False 让中文正常显示，而不是变成 \u...

GET 取数据（这里用一个公开的免费测试 API，能真的跑）：

import requests                       # 上面 pip install 过

# 向一个公开测试服务要一条假数据（无需 Key，可直接跑）
resp = requests.get("https://httpbin.org/get", params={"city": "北京"})
#      └ 方法    └ 网址(URL)             └ params 会自动拼成 ?city=北京

print(resp.status_code)              # 200  ← 先看状态码（L04）
data = resp.json()                   # 自动把返回的 JSON 解析成字典（省了 json.loads）
print(data["args"])                  # {'city': '北京'}  ← 服务器把我们传的参数原样回显

POST 交数据（提交一段内容，最接近之后调大模型的写法）：

import requests

payload = {"question": "你好，今天天气如何？"}   # 要提交的内容(字典)
resp = requests.post(
    "https://httpbin.org/post",
    json=payload,                    # 用 json= ，requests 自动序列化+设好请求头
    timeout=10,                      # 关键！最多等 10 秒，否则网络卡住会一直挂着
)
resp.raise_for_status()              # 若状态码是 4xx/5xx，这里直接抛错，提前发现问题
print(resp.json()["json"])           # {'question': '你好，今天天气如何？'}

import requests

api_key = "sk-你的密钥"                       # 先别急，下面讲更安全的存法
headers = {"Authorization": f"Bearer {api_key}"}  # 放在请求头，Bearer 是常见格式

resp = requests.get("https://api.example.com/data", headers=headers, timeout=10)
# 如果 Key 没带对，服务器会回 401（还记得吗？= 没出示会员卡）

最重要的一条安全铁律：绝不把 Key 直接写死在代码里、更不能提交到 GitHub。泄露的 Key 会被别人盗刷，账单能到几千块。正确做法是放进环境变量，代码只去"读"它：

# 在终端里设置环境变量（临时，当前窗口有效）
export API_KEY="sk-你的真实密钥"

# 更常用：把它写进项目根目录的 .env 文件（记得把 .env 加进 .gitignore！）

import os

api_key = os.environ["API_KEY"]     # 从环境变量读取，代码里不出现真实密钥
# 或用 os.getenv("API_KEY") ——读不到时返回 None 而不报错，可自行判断

if not api_key:
    raise RuntimeError("没找到 API_KEY，请先 export 或写进 .env")

✋ 动手：10 分钟调通一个真实 API

下面这段无需任何 Key，直接能跑，帮你把今天全部概念串一遍：

# 1. 装库（只需一次）
pip install requests

# 2. 存成 first_api.py 后运行： python first_api.py
import requests

# —— GET：向公开测试服务要数据 ——
r = requests.get("https://httpbin.org/get",
                 params={"name": "转行第7天"}, timeout=10)
print("状态码:", r.status_code)              # 期望 200
print("服务器收到的参数:", r.json()["args"]) # {'name': '转行第7天'}

# —— POST：提交一段内容（模拟给大模型发问题）——
r2 = requests.post("https://httpbin.org/post",
                   json={"question": "HTTP 是什么？"}, timeout=10)
r2.raise_for_status()                        # 不是 2xx 就报错
print("服务器收到的内容:", r2.json()["json"])# {'question': 'HTTP 是什么？'}

进阶挑战：把网址故意改成 https://httpbin.org/status/404，再打印 status_code，亲眼看看 404 长什么样，然后想想它对应"点餐"里的哪一幕。