# go-threads-api

> Go 实现的 Threads Android 私有 API SDK，通过 gRPC 为 Python 应用提供异步调用能力。

当前契约版本：0.3.0。本项目封装 Threads 私有 API，并非 Meta 官方 Graph API。
生成或修改调用代码前，请优先读取接口参考中的调用方式、请求字段和响应字段。

## API Documentation

- [模块与任务指南](docs/api/guide/): 按登录、资料、发帖和采集任务说明调用顺序与动态参数来源。
- [接口参考](docs/api/reference/): 9 个 Service、17 个 RPC 的调用、请求、响应和业务成功判定。
- [快速开始](docs/quick-start/): Python 客户端连接、鉴权和基础调用。
- [gRPC 完整参考](grpc/llms-full.txt): metadata、接口状态、请求响应字段及原始 Proto。
- [Python 调用参考](python/llms-full.txt): grpc.aio 客户端、公开异步方法和错误处理。
- [机器能力清单](capabilities.json): 结构化 RPC 状态、幂等性、副作用和门面映射。
- [Proto 契约](proto/): 请求、响应、字段号和 RPC 名称的唯一事实来源。
- [接口验证状态](docs/api/verification-status/): 已确认、已知上游错误和未实现接口。