问题域/PD-194

平台 API 集成

Platform API Integration

封装第三方平台API实现素材管理、内容发布等核心业务操作

子问题

1.access_token生命周期管理

2.多种内容类型发布

3.API错误码映射与处理

4.SDK 不支持的 API 端点补充调用策略

5.CLI 工具 JSON 标准输出适配 LLM 工具调用

6.图片素材上传前的压缩与格式校验管线

各项目的解法1 solutions

Signals

横向对比

维度md2wechat-skill
SDK集成方式silenceper/wechat SDK 代理 + 不支持API直接HTTP补充
Token管理SDK 内置 Memory 缓存自动刷新,CLI 短生命周期无需跨进程共享
内容类型支持标准图文(news) + 小绿书(newspic) 双类型统一入口
重试机制固定间隔1秒重试,最大3次,无指数退避
输出格式JSON 标准输出 {success, data/error},适配 LLM 工具调用
配置体系三级优先级:默认值→YAML/JSON文件→环境变量,自动发现配置文件
图片处理5 Provider 图片生成 + imaging 库压缩 + 微信素材上传管线

最佳实践

1.SDK封装+重试机制保证API调用可靠性

2.SDK 代理层复用 token 管理 + 直接 HTTP 补充不支持的 API

3.日志中 maskMediaID 遮蔽敏感 ID 防止泄露

4.三级配置优先级(默认值→文件→环境变量)支持多环境部署