Python开发API集成说明实战版提示词

角色定义与任务定位
请以一名资深Python后端开发工程师兼技术文档架构师的身份，进行内容创作。你的核心目标是：生成一份面向中级开发者的、可直接用于实战的API集成说明文档。这份文档需超越基础概念，聚焦于集成过程中的关键步骤、最佳实践、常见陷阱与调试技巧，确保读者能据此成功完成API对接。

适用场景

为内部项目编写第三方服务（如支付、地图、短信、云存储）的Python集成指南。
为自家产品撰写面向客户端开发者的API调用说明文档。
在技术博客或社区中分享特定API（如OpenAI、Twitter、Stripe）的Python集成实战经验。
构建标准化技术文档模板，用于团队知识沉淀。


核心提示词
以下提示词组合可直接或稍作修改后用于生成内容：

使用Python的requests库进行OAuth 2.0认证，并实现自动令牌刷新机制。
详解如何用Python处理API的速率限制（Rate Limiting），包含指数退避重试策略代码示例。
构建一个健壮的API客户端类，集成请求签名、异常处理（HTTP错误、网络超时、数据解析失败）与日志记录。
使用Pydantic模型对API的JSON请求参数与响应数据进行严格验证和序列化。
为异步API调用编写Python示例，使用aiohttp或httpx库提升并发性能。
演示如何利用unittest或pytest为API集成代码编写模拟（Mock）测试。
解析API文档中的Webhook配置，并使用Flask或FastAPI实现接收与验证端点。


风格方向

专业务实：语言精准、逻辑严密，避免文学化修饰，以代码和流程为核心。
面向实战：强调“怎么做”和“为什么这么做”，包含可直接运行的代码片段。
结构化清晰：采用模块化叙述，如“环境准备-认证流程-核心调用-错误处理-测试部署”。
视觉辅助：在描述流程时，提示生成序列图、状态流程图或代码结构图的关键词。


构图建议（针对配图或示意图）

架构图：展示“客户端 - 你的服务器 - 第三方API”之间的数据流与认证流。
代码截图焦点：特写关键函数（如认证、错误处理），语法高亮，背景简洁。
时序图：描绘一次完整的API调用与响应序列，包括重试环节。
仪表盘视图：展示API调用监控（如成功率、延迟）的模拟图表。


细节强化

环境变量管理：强调如何安全地存储API密钥（如使用python-dotenv或密钥管理服务）。
请求与响应日志：提示记录脱敏后的请求头、URL和响应时间，便于调试。
版本兼容性：注明所依赖的Python及关键库（requests, pydantic等）的版本范围。
安全性提醒：明确指出需要防范的漏洞，如密钥泄露、重放攻击、注入攻击。
性能考量：提及连接池、请求超时设置、异步调用对性能的影响。


使用建议

将“核心提示词”中的任意一条作为起点，输入给AI模型或作为您自己写作的大纲。
生成代码后，务必在本地或沙箱环境中进行测试验证，确保其可运行性。
可根据目标读者水平，调整代码示例的复杂度（如是否包含类型注解、是否使用高级库）。
结合“构图建议”，为关键步骤配图，能极大提升文档的可理解性。
在文档末尾，习惯性增加“常见问题（FAQ）”或“故障排除”章节，提升文档实用性。