用途:为使用 Memberful(Patreon 旗下会员与付费订阅平台)的开发者与运营者提供平台接入帮助,覆盖会员/订阅/通行证/优惠券的查询与变更、生命周期事件处理、登录集成与内容门控。
主要能力:通过 GraphQL API 操作会员数据;校验签名 Webhook 并响应注册、续费、退款等事件;为自有应用添加 Sign in with Memberful(OAuth SSO);用 WordPress 插件或建站工具做内容门控、私密播客与下载;把会员同步到 Discord、Mailchimp、Kit 或 CRM;了解套餐与交易费差异。
使用方式:GraphQL 只有一个端点,POST 到 https://ACCOUNT-URL.memberful.com/api/graphql,使用 Authorization: Bearer <key>(密钥来自 Settings → Custom applications,仅限服务端),可在仪表盘 API Explorer 中构建与测试。分页采用 Relay 游标(pageInfo.hasNextPage/endCursor)。Webhook 用 HMAC-SHA256 校验:对原始请求体与 Webhook secret 计算 HMAC-SHA256,与 X-Memberful-Webhook-Signature 做常量时间比较,随后再通过 GraphQL 重新查询权威状态。OAuth 的 code 换 token 必须在服务端中间件完成。
限制与注意:API 出错时仍返回 HTTP 200,需检查响应体 errors 数组;仪表盘“Plan”对应 API 的 Pass(会员),仪表盘“Price”对应 API 的 Plan(价格变体),命名混用是常见错误;Webhook 事件名大小写不一致(如 member_signup 与 member.deleted),需精确匹配;会员元数据仅限 API 设置,上限 50 个键、键 40 字符、值 500 字符;费用为 Free 10%、Pro/Premium 4.9%,叠加自有 Stripe 的 2.9%+30¢;Memberful 是订阅层而非托管平台,不提供课程/LMS 托管与营销邮件,需搭配 LMS 与邮件服务商。资料未提供具体价格金额与更多平台细节。