选题库

选题列表

分页列出选题库的分组与选题(规划页看板的数据源)。纯读,不会补建分组;全新工作区 groups 可能为空数组,不是异常。

GET/api/v1/ideas

ideas:read读档限流只读

鉴权与护栏

请求头 Authorization: Bearer <长期凭证>,凭证在设置页「接入外部系统 → 长期凭证」签发,见鉴权与权限。
凭证需带 scope ideas:read;签发者在工作区里的角色也要允许该动作。
限流:读档,每分钟 60 次(按凭证计),超出回 429 并带 Retry-After。
幂等:读端点,无需 Idempotency-Key。
只读端点:不写库、不外发。

查询参数

groupIdstring可选

只看某个分组。

limitinteger 1–100可选

每页条数,默认 20。

cursorstring可选

上一页返回的 nextCursor。

响应

成功返回 HTTP 200,信封为 { data, meta };右侧(窄屏在本页末尾)给出了各状态码的示例。所有错误都是 { error: { code, message, params }, meta },按机器码处理而不是按 message 匹配,码表见错误码。

状态码	可能的错误码
400	`invalid_input`
401	`unauthenticated`
403	`forbidden` / `workspace_not_found`
404	`not_found`
429	`rate_limited`
500	`internal`

示例

请求

curl -X GET "https://popkit.loxily.com/api/v1/ideas" \
  -H "Authorization: Bearer popkit_it_••••••••"

响应

成功

{
  "data": {
    "groups": [
      {
        "id": "idg_01J8…",
        "name": "未分组",
        "isDefault": true
      },
      {
        "id": "idg_01J9…",
        "name": "十月活动",
        "isDefault": false
      }
    ],
    "ideas": [
      {
        "id": "ide_01J8ZS…",
        "groupId": "idg_01J9…",
        "content": "国庆档「一次创作,多平台发布」教程短视频",
        "tags": [
          {
            "label": "教程",
            "color": "blue"
          }
        ],
        "image": null,
        "plannedAt": "2026-09-28T02:00:00.000Z",
        "targetAccountIds": [],
        "createdBy": "usr_01J7…",
        "creatorName": "Amy",
        "createdAt": "2026-09-20T03:15:00.000Z"
      }
    ],
    "nextCursor": null,
    "deepLink": "https://popkit.loxily.com/planning"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c78"
  }
}