用途:在客户现有应用中实现或改进 OnlyFans AI 聊天机器人集成,复用其 HTTP 客户端、持久化、队列与测试。OnlyFansAPI 提供账号事件与消息能力,模型、创作者语气、内容与审批规则由客户选择。构建集成不等于授权发送实时消息、注册 Webhook 或部署。
主要能力:可连接 OnlyFansAPI 的 Docs MCP(https://docs.onlyfansapi.com/api/mcp,无需认证,适合构建期)或 API MCP(https://app.onlyfansapi.com/mcp/onlyfans-mcp,需 API-key 或 OAuth)。支持接收并排队事件、协调对话、发送与核对消息、处理可选购买与媒体。
使用方式:先阅读聊天机器人教程、交付规则、签名指南与 Send Message 文档。为 HTTPS Webhook 配置签名密钥,在校验 Signature 头(原始请求体字节上的十六进制 HMAC-SHA256)后再解析 JSON,拒绝缺失或格式错误的签名,并使用常量时间比较。校验事件类型、创作者账号、聊天身份与必填字段,用 webhook 的 account_id(acct_…)标识 API 账号,按账号和聊天命名空间持久化状态。在返回 2xx 前(10 秒预算内)原子化持久化去重事件与持久工作;按 X-OFAPI-Idempotency-Key 去重,保留源消息 ID。事件可能乱序,需用时间戳与消息 ID 重建历史;typing 事件是短暂的,不带幂等键。发送使用 POST /api/{account}/chats/{chat_id}/messages,服务端从 ONLYFANSAPI_API_KEY 读取密钥,Authorization: Bearer <API_KEY>。发送前持久化唯一的出站 Idempotency-Key 与精确请求载荷。
适用场景:需要按账号与聊天串行化回复、处理短消息爆发、支持打字截止时间(约 5–10 秒)、区分人工接管、以及处理 messages.received、users.typing、messages.ppv.unlocked、messages.sent 等事件的集成。
限制:构建集成不授权实时消息、Webhook 注册或部署;不得生成新密钥强行重试或承诺精确一次投递;超时或服务失败可能留下不确定状态,需持久化并与聊天历史核对;拉取聊天消息可能标记已读,不应作为持续新消息轮询器;媒体上传的 HTTP 202 仅表示已接受,需等待完成。缺失的收费、价格与平台细节暂未提供。