平台API连接器

导航开发者门户并获取社交/内容平台的API凭证。将凭证存储在Supabase（或任何数据库）中以便重复使用。

通用模式

1. 1. 在平台的开发者门户上创建开发者应用
2. 配置OAuth重定向URI和作用域
3. 完成OAuth流程（或生成API密钥）
4. 以结构化格式存储凭证
5. 通过简单的API调用进行测试

Facebook + Instagram

Facebook和Instagram共享相同的认证系统。一个Facebook主页令牌即可解锁两者。

设置

1. 1. 访问 developers.facebook.com/apps → 创建应用 → 商业类型
2. 添加Facebook登录产品
3. 在Graph API Explorer（developers.facebook.com/tools/explorer/）中：

- 选择你的应用 - 添加权限：pagesshowlist、pagesreadengagement、pagesmanageposts、instagrambasic、instagramcontent_publish - 生成用户访问令牌 → 授权 - 交换为长期令牌：GET /oauth/accesstoken?granttype=fbexchangetoken&clientid={appid}&clientsecret={secret}&fbexchangetoken={shorttoken}

1. 4. 获取主页访问令牌：GET /me/accounts → 找到主页 → 复制 accesstoken
2. 获取Instagram商业账户ID：GET /{pageid}?fields=instagrambusinessaccount

存储

json { platform: facebook, credentials: { app_id: ..., app_secret: ..., page_id: ..., pageaccesstoken: ..., iguserid: ... } }

关键陷阱

来自Graph API Explorer的主页访问令牌是短期有效的，除非你先将用户令牌交换为长期令牌，然后从长期用户令牌请求主页令牌。从长期用户令牌派生出的主页令牌是永久的（无过期时间）。

YouTube

设置

1. 1. 访问 console.cloud.google.com → API和服务 → 凭据
2. 创建OAuth 2.0客户端ID（Web应用程序类型）
3. 添加重定向URI：http://localhost:8422/callback（或你的回调URL）
4. 启用YouTube Data API v3
5. 运行本地OAuth流程：

python
from googleauthoauthlib.flow import InstalledAppFlow

flow = InstalledAppFlow.fromclientsecrets_file(
credentials.json,
scopes=[https://www.googleapis.com/auth/youtube.upload,
https://www.googleapis.com/auth/youtube.readonly]
)
creds = flow.runlocalserver(port=8422)

creds.token, creds.refresh_token, creds.expiry

存储

json { platform: youtube, credentials: { client_id: ..., client_secret: ..., access_token: ..., refresh_token: ..., token_expiry: ... } }

关键陷阱

如果用户之前使用有限的作用域进行了授权，刷新令牌可能不涵盖 youtube.upload。必须使用 prompt=consent 重新授权，以获取具有完整作用域的新刷新令牌。

Twitter/X

设置

1. 1. 访问 developer.x.com/en/portal/dashboard
2. 创建项目 + 应用（免费套餐：每月100条帖子）
3. 在密钥和令牌下：

- API密钥 + 密钥（消费者凭证） - Bearer令牌（仅应用认证，用于读取） - 访问令牌 + 密钥（用户认证，用于发布）— 使用读取和写入权限生成

1. 4. 如果生成令牌时权限为只读，则在更改为读取和写入后重新生成访问令牌

存储

json { platform: twitter, credentials: { api_key: ..., api_secret: ..., bearer_token: ..., access_token: ..., accesstokensecret: ... } }

关键陷阱

免费套餐限制为每月100条帖子（按结算日期重置，而非自然月）。免费套餐不支持删除或分析功能。

TikTok

设置

1. 1. 访问 developers.tiktok.com → 创建应用
2. 添加产品：登录工具包 + 内容发布API
3. 配置：应用图标（1024x1024）、分类、服务条款URL、隐私政策URL、重定向URI
4. 提交审核 — TikTok要求提供展示应用运行状态的演示视频
5. 在审核通过前，使用手动模式（生成内容但手动发布）

关键陷阱

TikTok内容发布API需要包含演示视频的完整应用审核。这需要数天到数周的时间。建议将手动模式作为临时解决方案。登录工具包可在沙盒模式下用于开发。

凭证存储模式

使用包含JSONB的单个表以实现灵活性：

sql
CREATE TABLE platform_connections (
id UUID PRIMARY KEY DEFAULT genrandomuuid(),
platform TEXT NOT NULL,
account_name TEXT,
credentials JSONB NOT NULL,
scopes TEXT[],
status TEXT DEFAULT active,
created_at TIMESTAMPTZ DEFAULT now(),
updated_at TIMESTAMPTZ DEFAULT now()
);

JSONB可以适应不同平台的认证格式，无需修改表结构。

令牌刷新模式

python
async def getvalidtoken(platform: str) -> dict:
conn = await get_connection(platform)
creds = conn[credentials]

if platform == youtube and isexpired(creds.get(tokenexpiry)):
newtoken = refreshgoogletoken(creds[refreshtoken], creds[clientid], creds[clientsecret])
creds[accesstoken] = newtoken
await update_connection(conn[id], creds)

# Facebook主页令牌不会过期（如果从长期用户令牌派生）
# Twitter令牌不会过期
# TikTok令牌24小时后过期 — 使用refresh_token刷新

return creds