📘 工具调用与外部API集成实战 30章

⚡ 风格 · 明快活力

API 基础认知

什么是 API、工作原理（请求-响应模型）、RESTful 设计风格简介

HTTP 协议核心

请求方法 (GET/POST/PUT/DELETE)、状态码 (200/404/500)、请求头与响应头

Python 请求库入门

安装 requests、第一个 GET 请求、处理响应对象 (text/json/status_code)

处理 JSON 数据

JSON 格式解析、Python 字典与 JSON 互转、json() 方法提取数据

带参数的 GET 请求

URL 参数拼接、params 参数传递、处理分页数据

POST 请求与数据提交

发送表单数据、发送 JSON 数据、设置 Content-Type 头

请求头与认证

自定义请求头、Bearer Token 认证、Basic Auth 认证

处理错误与异常

HTTP 错误状态码、网络超时设置、重试机制 (适配器)

Session 与会话管理

requests.Session 保持会话、Cookie 持久化、模拟登录

文件上传与下载

files 参数上传文件、流式下载大文件、断点续传思路

API 速率限制与限流

理解 Rate Limiting、处理 429 状态码、指数退避算法

异步 HTTP 请求

aiohttp 库入门、异步 GET/POST、并发请求性能对比

WebSocket 基础

WebSocket 协议简介、websockets 库建立连接、实时数据推送

GraphQL API 调用

GraphQL 与 REST 区别、发送 GraphQL 查询、处理嵌套数据

OpenAPI/Swagger 规范

理解 OpenAPI 文档、swagger-client 生成客户端代码

API 网关与聚合

什么是 API 网关、Python 聚合多个 API 响应、数据合并策略

内存缓存 (lru_cache)、Redis 缓存 API 响应、设置过期时间

日志与监控

logging 记录 API 调用日志、结构化日志、集成 Sentry

测试 API 接口

pytest 编写 API 测试、Mock 外部服务 (responses)、测试覆盖率

API 文档生成

Sphinx 生成文档、集成 OpenAPI 规范、自动生成 API 参考手册

微服务间通信

gRPC 基础、定义 proto 文件、Python gRPC 客户端/服务端

消息队列集成

RabbitMQ / pika 客户端、发布/订阅模式、任务队列

OAuth 2.0 授权流程

授权码模式、requests-oauthlib 获取令牌、刷新令牌

API 安全最佳实践

HTTPS 强制、输入验证、防止 SSRF、API 密钥管理

CI/CD 中的 API 集成

GitHub Actions 运行 API 测试、自动化部署更新 API 配置

云服务 API 集成 (AWS)

boto3 调用 S3 API、AWS 签名版本 4、错误重试

第三方支付 API 集成

支付宝/微信支付流程、签名生成、回调处理

社交媒体 API 集成

Twitter API v2 调用、OAuth 1.0a、流式获取推文

地图与位置服务 API

高德/百度地图 API、地理编码、路径规划

综合实战：天气查询 CLI

聚合多个天气 API、缓存结果、输出格式化