Memene API

开发文档
开发者控制台
Meme 服务按用户 ID 获取订阅方案(频道)列表
Meme 服务

按用户 ID 获取订阅方案(频道)列表需要认证¥0.005/次

GET/v1/meme/subscribePlans

接口说明

按 Memene 用户 ID 获取该用户所拥有的全部订阅方案(在 Memene 产品体系内也称为 "频道")列表。每个方案都对应一份持续产出的日报。配合 查询订阅方案历史日报接口,可以串起完整的 "从用户 → 方案 → 该方案历次日报" 数据链路。

该接口默认仅对 admin / special 等内部层级角色开放文档可见性,请在拿到 API 调试授权后再使用。

典型用法(AI 调用建议的两步流程):

  1. 先调用本接口,根据已知用户 ID 拿到 planId 列表,从中筛选目标频道。
  2. 再用 planId 调用历史日报接口翻页阅读该频道历史内容。

查询参数:

  • userId:必填,Memene 平台上目标用户的 UUID 字符串。可以通过 https://memene.cn/settings 的【客服支持】-> 【与我们反馈】的复制信息获取到相应的内容。

返回值字段(精简到对外可消费部分):

字段类型含义
planIdstring订阅方案 ID。下一步调用 dailySummaries 时填入此字段
planNamestring方案名称(即频道名)
planDescriptionstring方案文字描述,可作为搜索匹配文本
planAvatarUrlstring | null方案封面图,便于卡片展示
planTagsstring[]方案标签数组(上游为字符串时会按逗号切分)
domainstring所属领域,如 "AI"、"财经"
planTypestring方案类型(如 "paid"、"free")
isActiveboolean是否仍在持续产出日报
isSharedboolean是否公开可被订阅
userIdstring方案所属用户 ID(与查询参数一致)
userNamestring用户展示名
avatarstring | null用户头像
userLevelstring用户等级标识
verificationLevelstring用户认证等级
isVerifiedboolean用户是否已认证

上游冗余字段(如 subscribe_plan_subscribe_source_subscribe_sources 等)已在 本服务侧过滤掉,避免对外结构频繁变化。

错误说明:

HTTP 状态码含义
400userId 缺失或格式错误
401API Key 无效
402余额不足
502上游 Meme API 服务暂时不可用

授权说明:

  • 需要提供有效的 API Key(Bearer Token)
  • 每次调用按 unitPrice 扣除相应费用,失败时自动退还
请求头
参数类型必填说明
Authorizationstring

从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式,例如:Bearer sk_memene_xxx_yyy。可以 点击此处 获取 API KEY

请求参数
参数类型必填说明
userIdstring

订阅方案所属用户的 Memene 用户 ID(UUID 字符串)。返回该用户名下的所有订阅方案概览。

响应结构
200

Default Response

application/json
字段类型说明
statusCodenumber

状态码。

statusTextstring

状态文本。

dataarray

该用户名下的全部订阅方案列表,可能为空数组。

planIdstring

订阅方案 ID(cuid 字符串)。可作为历史日报接口的查询条件。

planNamestring

订阅方案名称。

planDescriptionstring

订阅方案文字描述。

planAvatarUrlstring

订阅方案封面图地址,可能为 null。

planTagsarray

订阅方案标签列表。上游返回字符串时会按逗号切分为数组。

domainstring

订阅方案所属领域,如 "AI"、"财经"。

planTypestring

订阅方案类型,如 "paid"、"free"。

isActiveboolean

订阅方案是否处于激活状态(是否在持续产生日报)。

isSharedboolean

订阅方案是否公开可被他人订阅。

userIdstring

订阅方案所属用户的 ID(即查询参数中的 userId)。

userNamestring

订阅方案所属用户的展示名。

avatarstring

订阅方案所属用户的头像 URL。

userLevelstring

用户等级标识,如 "Admin"、"User"。仅供展示,不参与计费。

verificationLevelstring

用户认证等级(None / Verified 等)。

isVerifiedboolean

用户是否已通过认证。

示例
json
{
  "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
    }
  ]
}
400

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Bad Request",
  "message": "缺少 userId"
}
401

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Unauthorized",
  "message": "无效的 API Key"
}
402

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Payment Required",
  "message": "余额不足"
}
502

Default Response

application/json
字段类型说明
errorstring
messagestring
示例
json
{
  "error": "Bad Gateway",
  "message": "上游 Meme API 服务暂时不可用"
}