按用户 ID 获取订阅方案(频道)列表需要认证¥0.005/次
/v1/meme/subscribePlans接口说明
按 Memene 用户 ID 获取该用户所拥有的全部订阅方案(在 Memene 产品体系内也称为 "频道")列表。每个方案都对应一份持续产出的日报。配合 查询订阅方案历史日报接口,可以串起完整的 "从用户 → 方案 → 该方案历次日报" 数据链路。
该接口默认仅对 admin / special 等内部层级角色开放文档可见性,请在拿到 API 调试授权后再使用。
典型用法(AI 调用建议的两步流程):
- 先调用本接口,根据已知用户 ID 拿到
planId列表,从中筛选目标频道。 - 再用
planId调用历史日报接口翻页阅读该频道历史内容。
查询参数:
userId:必填,Memene 平台上目标用户的 UUID 字符串。可以通过 https://memene.cn/settings 的【客服支持】-> 【与我们反馈】的复制信息获取到相应的内容。
返回值字段(精简到对外可消费部分):
| 字段 | 类型 | 含义 |
|---|---|---|
planId | string | 订阅方案 ID。下一步调用 dailySummaries 时填入此字段 |
planName | string | 方案名称(即频道名) |
planDescription | string | 方案文字描述,可作为搜索匹配文本 |
planAvatarUrl | string | null | 方案封面图,便于卡片展示 |
planTags | string[] | 方案标签数组(上游为字符串时会按逗号切分) |
domain | string | 所属领域,如 "AI"、"财经" |
planType | string | 方案类型(如 "paid"、"free") |
isActive | boolean | 是否仍在持续产出日报 |
isShared | boolean | 是否公开可被订阅 |
userId | string | 方案所属用户 ID(与查询参数一致) |
userName | string | 用户展示名 |
avatar | string | null | 用户头像 |
userLevel | string | 用户等级标识 |
verificationLevel | string | 用户认证等级 |
isVerified | boolean | 用户是否已认证 |
上游冗余字段(如
subscribe_plan_subscribe_source_subscribe_sources等)已在 本服务侧过滤掉,避免对外结构频繁变化。
错误说明:
| HTTP 状态码 | 含义 |
|---|---|
| 400 | userId 缺失或格式错误 |
| 401 | API Key 无效 |
| 402 | 余额不足 |
| 502 | 上游 Meme API 服务暂时不可用 |
授权说明:
- 需要提供有效的 API Key(Bearer Token)
- 每次调用按
unitPrice扣除相应费用,失败时自动退还
从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式,例如:Bearer sk_memene_xxx_yyy。可以 点击此处 获取 API KEY
订阅方案所属用户的 Memene 用户 ID(UUID 字符串)。返回该用户名下的所有订阅方案概览。
Default Response
状态码。
状态文本。
该用户名下的全部订阅方案列表,可能为空数组。
订阅方案 ID(cuid 字符串)。可作为历史日报接口的查询条件。
订阅方案名称。
订阅方案文字描述。
订阅方案封面图地址,可能为 null。
订阅方案标签列表。上游返回字符串时会按逗号切分为数组。
订阅方案所属领域,如 "AI"、"财经"。
订阅方案类型,如 "paid"、"free"。
订阅方案是否处于激活状态(是否在持续产生日报)。
订阅方案是否公开可被他人订阅。
订阅方案所属用户的 ID(即查询参数中的 userId)。
订阅方案所属用户的展示名。
订阅方案所属用户的头像 URL。
用户等级标识,如 "Admin"、"User"。仅供展示,不参与计费。
用户认证等级(None / Verified 等)。
用户是否已通过认证。
{
"statusCode": 200,
"statusText": "OK",
"data": [
{
"planId": "cm6u2wnxw0000pbv90wk75eff",
"planName": "人工智能前瞻报",
"planDescription": "聚合每日 AI 领域核心动态与深度文章。",
"planAvatarUrl": "https://yuansun-assests.oss-cn-hangzhou.aliyuncs.com/newsdiy/assets/subscribeChannel/templatePlanCover/cat_01.jpg",
"planTags": [
"AI",
"LLM"
],
"domain": "AI",
"planType": "paid",
"isActive": true,
"isShared": true,
"userId": "3fba38e1-f98d-4f2e-807c-7c5761f2ca51",
"userName": "元狲开发组",
"avatar": "http://yuansun-account-avatar.oss-cn-hangzhou.aliyuncs.com/newsdiy/example.jpg",
"userLevel": "Admin",
"verificationLevel": "None",
"isVerified": false
}
]
}Default Response
{
"error": "Bad Request",
"message": "缺少 userId"
}Default Response
{
"error": "Unauthorized",
"message": "无效的 API Key"
}Default Response
{
"error": "Payment Required",
"message": "余额不足"
}Default Response
{
"error": "Bad Gateway",
"message": "上游 Meme API 服务暂时不可用"
}