登录 注册

Cubox 部分网页接口

本贴最后更新于 730 天前，其中的信息可能已经斗转星移

本文分享通过抓包获得的 Cubox 网页接口，涵盖 Cubox 网页端可能进行的大部分操作。为避免歧义 Cubox 登录后以卡片形式展示的内容在下文均以“卡片”指代。

登录 Cubox

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/login

参数说明：

  • userName：用户名
  • password：用户密码，需要进行 MD5 加密
  • autoLogin：是否自动登录

请求头：

添加 content-type 为 application/x-www-form-urlencoded

请求体：

userName=用户名&password=用户密码&autoLogin=自动登录

返回值：

{
  "message": "login success",
  "code": 200,
  "data": null,
  "token": "用于后续鉴权",
  "userId": "用户ID"
}
​

卡片操作

获取卡片列表

请求类型：GET 请求

请求链接：URL + ?asc=false&page=1&filters=&archiving=false

参数说明：

  • asc：按创建时间日期，从新到旧
  • page：页码（一页最多 49 个）
  • filters：0: 文章、网页, 1: 片段, 2: 速记, 3: 图片, 4: 语音, 5: 视频, 6: 文件
  • archiving：是否在归档卡片中搜索，是的话将会返回归档卡片的列表，不含未归档的卡片
  • starTarget：星标卡片（默认不含该参数）
  • tagId：使用指定标签卡片（默认不含该参数），未指定 id 会返回所有无标签卡片
  • groupId：指定收藏夹卡片（默认不含该参数）

URL 说明

获取卡片信息

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/search_engine/visit/卡片 ID

请求体：无请求体

返回值：

{
  "message": "",
  "code": 200,
  "data": {
    "userSearchEngineID": "ff80808184793cdd01847b3e6be1422e",
    "title": "标题",
    "description": "简述",
    "targetURL": "原文链接",
    "resourceURL": null,
    "homeURL": "mp.weixin.qq.com",
    "archiveName": "archive/1668515023709/243525.html",
    "content": "剪藏内容 HTML",
    "articleName": "unAYy3",
    "articleWordCount": 2587,
    "byline": "原文作者",
    "cover": "surface/2022111520231896973/70906.jpg",
    "articleURL": null,
    "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
    "archiving": false,
    "starTarget": null,
    "hasMark": false,
    "isRead": true,
    "markCount": 0,
    "tags": [
      {
        "tagID": "ff808081847930d401847b52dcaf5bc1",
        "name": "标签名",
        "rank": 3,
        "updateTime": "2022-11-15T21:07:59:033+08:00",
        "parentId": null
      }
    ],
    "allTags": [],
    "marks": [],
    "groupId": "ff8080817e05ac27017e06c64fed0def",
    "groupName": "",
    "createTime": "2022-11-15T20:23:18:937+08:00",
    "updateTime": "2022-11-15T21:07:59:033+08:00",
    "status": "Updated",
    "finished": true,
    "inBlackOrWhiteList": false,
    "type": 0
  }
}
​

获取卡片原文及标注

请求类型：GET 请求

请求链接：https://cubox.pro/c/api/bookmark/content?bookmarkId=卡片 ID

返回值：

{
    "message": "",
    "code": 200,
    "data": {
        "marks": [
            {
                "markID": "ff80808184acf0460184bb88db773f16",
                "startParentTagName": "SPAN",
                "startTextOffset": 8,
                "startParentIndex": 63,
                "endParentTagName": "SPAN",
                "endTextOffset": 28,
                "endParentIndex": 68,
                "index": 0,
                "text": "标注文本",
                "createTime": "2022-11-28T08:00:19:319+08:00",
                "updateTime": "2022-11-28T08:00:38:401+08:00",
                "engineID": "ff80808184a8c17f0184aa51f7137637",
                "noteText": "标注笔记",
                "links": null,
                "type": 0,
                "ratio": null,
                "url": null,
                "cover": null,
                "isPrivate": false,
                "status": null
            },
            {
                "markID": "ff80808184acf6880184bb8bbf01426c",
                "startParentTagName": "IMG",
                "startTextOffset": 0,
                "startParentIndex": 5,
                "endParentTagName": "IMG",
                "endTextOffset": 0,
                "endParentIndex": 5,
                "index": 0,
                "text": "",
                "createTime": "2022-11-28T08:03:28:641+08:00",
                "updateTime": "2022-11-28T08:03:57:016+08:00",
                "engineID": "ff80808184a8c17f0184aa51f7137637",
                "noteText": "",
                "links": null,
                "type": 0,
                "ratio": null,
                "url": "图片 URL",
                "cover": null,
                "isPrivate": false,
                "status": null
            },
        ],
        "content": "卡片 HTML 内容"
    }
}
​

标签操作

更新文档标签

注意：

这个请求发送的标签会覆盖原有标签，可以使用未创建的标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/v3/search_engine/update

请求头：

添加 content-type 为 application/x-www-form-urlencoded

请求体：

userSearchEngineID=卡片的ID&linkedTagNames=[{"name":"标签的名字"}]

返回值：

{
  "message": "",
  "code": 200,
  "data": {
    "userSearchEngineID": "ff808081842cc4c1018454d193d735d1",
    "title": "标题",
    "description": "简述",
    "targetURL": "原文链接",
    "resourceURL": null,
    "homeURL": "mp.weixin.qq.com",
    "archiveName": "archive/1667870336862/595265.html",
    "content": "剪藏内容 HTML",
    "articleName": "3repjS",
    "articleWordCount": 2151,
    "byline": "文章作者",
    "cover": "surface/2022110809185127032/14815.jpg",
    "articleURL": null,
    "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
    "archiving": false,
    "starTarget": null,
    "hasMark": false,
    "isRead": false,
    "markCount": 0,
    "tags": [
      {
        "tagID": "ff8080818479358001847b60518921b1",
        "name": "标签名",
        "rank": 5,
        "updateTime": "2022-11-15T21:03:56:023+08:00",
        "parentId": null
      }
    ],
    "allTags": [
      {
        "tagID": "ff8080818479358001847b60518921b1",
        "name": "标签名",
        "rank": 5,
        "createTime": "2022-11-15T21:00:20:740+08:00",
        "updateTime": "2022-11-15T21:00:20:740+08:00",
        "state": 1,
        "bookmarkCount": null,
        "parentId": null
      }
    ],
    "marks": [],
    "groupId": "ff8080817e05ac27017e06c64fed0def",
    "groupName": "",
    "createTime": "2022-11-08T09:18:51:470+08:00",
    "updateTime": "2022-11-15T21:03:56:023+08:00",
    "status": "Updated",
    "finished": true,
    "inBlackOrWhiteList": false,
    "type": 0
  }
}
​

批量更新文档标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/v2/search_engines/updateTagsForName

请求头：

添加 content-type 为 application/x-www-form-urlencoded

请求体：

searchEngineIds="卡片ID,卡片ID"&deleteTagIds="删除标签ID,删除标签"&addLinkedTagNames=[{"name":"标签的名字"}]

返回值：

{
  "message": "",
  "code": 200,
  "data": {
    "tags": [
      {
        "tagID": "添加标签的ID",
        "name": "添加标签的标签名",
        "rank": 10,
        "createTime": "2022-11-25T20:57:27:134+08:00",
        "updateTime": "2022-11-25T21:40:53:854+08:00",
        "state": 1,
        "bookmarkCount": null,
        "parentId": null
      }
    ],
    "searchEngines": [
      {
        "userSearchEngineID": "文档一ID",
        "title": null,
        "description": null,
        "targetURL": null,
        "resourceURL": null,
        "homeURL": null,
        "archiveName": null,
        "content": null,
        "articleName": null,
        "articleWordCount": 0,
        "byline": "",
        "cover": null,
        "articleURL": null,
        "littleIcon": null,
        "archiving": null,
        "starTarget": null,
        "hasMark": null,
        "isRead": null,
        "markCount": null,
        "tags": [
          {
            "tagID": "添加标签的ID",
            "name": "添加标签的标签名",
            "rank": 10,
            "updateTime": null,
            "parentId": null
          }
        ],
        "allTags": [],
        "marks": [],
        "groupId": null,
        "groupName": null,
        "createTime": null,
        "updateTime": null,
        "status": null,
        "finished": null,
        "inBlackOrWhiteList": null,
        "type": 0
      }
    ]
  }
}
​

获取标签列表

请求类型：GET 请求

请求链接：https://cubox.pro/c/api/v2/tag/list

返回值：

{
  "message": "",
  "code": 200,
  "data": {
    "hasNoTagEngineCount": 640,
    "tagList": [
      {
        "tagID": "标签ID",
        "name": "标签名",
        "rank": 0,	# 标签序号
        "createTime": null,
        "updateTime": null,
        "state": null,
        "bookmarkCount": 0,	# 标记数量
        "parentId": null
      },
      {
        "tagID": "标签ID",
        "name": "标签名",
        "rank": 1,	# 标签序号
        "createTime": null,
        "updateTime": null,
        "state": null,
        "bookmarkCount": 1,	# 标记数量
        "parentId": null
      }
    ]
  }
}
​

获取最近使用标签列表

请求类型：GET 请求

请求链接：https://cubox.pro/c/api/tag/use/recent

返回值：

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "ff8080818479358001847b60518921b1",
      "name": "标签1",
      "link": null
    },
    {
      "tagID": "ff80808184793cdd01847bcc40241841",
      "name": "标签2",
      "link": null
    },
    {
      "tagID": "ff808081847930d401847bcb946348a5",
      "name": "标签3",
      "link": null
    },
    {
      "tagID": "ff808081847930d401847b52dcaf5bc1",
      "name": "标签4",
      "link": null
    },
    {
      "tagID": "ff8080818479358001847b586eda192b",
      "name": "标签5",
      "link": null
    }
  ]
}
​

新建标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/v2/tag/new

请求头：

添加 content-type 为 application/x-www-form-urlencoded

请求体：

linkedName=标签名

可选参数：parentId=父标签ID

返回值：

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "ff8080818479358001847b60518921b1",
      "name": "标签6",
      "rank": 5,	# 第六个标签
      "createTime": "2022-11-15T21:00:20:740+08:00",
      "updateTime": "2022-11-15T21:00:20:740+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": null
    }
  ]
}
​

删除标签

注意：该操作会删除标签及标签下的子标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/tags/delete

请求体：

ids=标签ID 或

{
    "ids": 标签ID	# List，或使用","分隔的 String
}
​

返回值：

{
  "message": "",
  "code": 200,
  "data": null
}
​

重命名标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/tag/update

请求体：

id=标签ID&name=新标签名 或

{
    "id": 标签ID,
    "name": 标签名
}
​

返回值：

{
  "message": "",
  "code": 200,
  "data": {
    "tagID": "标签ID",
    "name": "标签名",
    "rank": 0,
    "createTime": "2022-11-25T20:39:29:271+08:00",
    "updateTime": "2022-11-25T20:42:18:017+08:00",
    "state": 1,
    "bookmarkCount": null,
    "parentId": "父标签ID"
  }
}
​

合并标签

注意：该操作会将被合并标签的子标签也一并合并

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/tag/merge

请求体：

mergedTagId="目标标签ID"&mergeTagIds="标签一ID,标签二ID" 或

{
    "mergedTagId": merged_tag_id,
    # 单标签：String
    # 多标签：List，或使用","分隔的 String
    "mergeTagIds": merge_tag_ids
}
​

返回值：

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "目标标签ID",
      "name": "目标标签名",
      "rank": 8,
      "createTime": "2022-11-25T20:39:18:622+08:00",
      "updateTime": "2022-11-25T20:39:18:622+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": null
    }
  ]
}
​

移动标签

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/tag/move

请求体：

movedTagId="目标标签ID"&moveTagIds="标签一ID,标签二ID" 或

{
    "movedTagId": 目标标签ID,
    "moveTagIds": [
        "标签一ID"
    ]
}
​

返回值：

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "被移动标签ID",
      "name": "标签名",
      "rank": 0,
      "createTime": "2022-11-25T20:39:18:622+08:00",
      "updateTime": "2022-11-25T20:54:49:899+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": "目标标签ID"
    }
  ]
}
​

标签归类

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/tag/sort

请求体：

targetPriorBrotherId 和 targetParentId 选填一个，都为空会将标签移到标签树顶端

sourceTagId="被移动的标签ID"&targetPriorBrotherId="移动到该标签后" 或

sourceTagId="被移动的标签ID"&targetParentId="移动到该标签下" 或

{
    "sourceTagId": "被移动的标签ID",
    "targetPriorBrotherId": "移动到该标签后",
    "targetParentId": "移动到该标签下"
}
​

返回值：

该方法返回被移动标签及该标签后的所有同级标签

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "被移动标签的ID",
      "name": "被移动标签名",
      "rank": 0,
      "createTime": "2022-11-26T00:00:00:470+08:00",
      "updateTime": "2022-11-26T00:15:52:189+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": "被移动标签的父标签ID"
    },
    {
      "tagID": "被移动标签的同级标签ID",
      "name": "被移动标签的同级标签名",
      "rank": 1,
      "createTime": "2022-11-25T23:50:09:670+08:00",
      "updateTime": "2022-11-26T00:15:40:569+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": "ff80808184acf2d60184af85297107fe"
    }
  ]
}
​

标注操作

获取最近标注文档

请求类型：GET 请求

请求链接：https://cubox.pro/c/api/mark/search_engine/latest

返回值：

注意：该方法仅返回最后高亮的九篇文章

{
  "message": "Get SearchEngine successfully",
  "code": 200,
  "data": [
    {
      "userSearchEngineID": "ff8080818484e31b018485f7e80d273e",
      "title": "文章标题",
      "description": "文章摘要",
      "targetURL": "文章链接",
      "resourceURL": null,
      "homeURL": "mp.weixin.qq.com",
      "archiveName": null,
      "content": "",
      "articleName": null,
      "articleWordCount": 0,
      "byline": "",
      "cover": "surface/2022111722220619093/98525.jpg",
      "articleURL": null,
      "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
      "archiving": false,
      "starTarget": false,
      "hasMark": true,
      "isRead": null,
      "markCount": 2,
      "tags": [],
      "allTags": [],
      "marks": [],
      "groupId": "ff8080817e05ac27017e06c64fed0def",
      "groupName": "",
      "createTime": "2022-11-17T22:22:06:944+08:00",
      "updateTime": "2022-11-18T23:30:40:924+08:00",
      "status": "normal",
      "finished": null,
      "inBlackOrWhiteList": false,
      "type": 0
    }
  ]
}
​

获取标注列表

请求类型：GET 请求

请求链接：https://cubox.pro/c/api/v2/mark

请求参数：?asc=false&filters=

  • asc：按创建时间日期，从新到旧
  • lastTimestamp：最后标注时间（上一个请求最后一个的创建时间，初次请求时不需要这个参数）
  • filters：0: 文章、网页, 1: 片段, 2: 速记, 3: 图片, 4: 语音, 5: 视频, 6: 文件

返回值：

{
  "message": "",
  "code": 200,
  "data": [
    {
      "markID": "ff808081848a0ab901848b5d089c45de",
      "startParentTagName": "IMG",
      "startTextOffset": 0,
      "startParentIndex": 5,
      "endParentTagName": "IMG",
      "endTextOffset": 0,
      "endParentIndex": 5,
      "index": 0,
      "text": "",
      "createTime": "2022-11-18T23:30:40:924+08:00",
      "updateTime": "2022-11-18T23:30:40:924+08:00",
      "engineID": "ff8080818484e31b018485f7e80d273e",
      "noteText": "",
      "links": null,
      "type": 1,
      "ratio": 1.3274216,
      "url": "封面图链接",
      "cover": "",
      "isPrivate": false,
      "searchEngine": {
        "userSearchEngineID": "ff8080818484e31b018485f7e80d273e",
        "title": "文章标题",
        "description": "文章摘要",
        "targetURL": "文章链接",
        "resourceURL": null,
        "homeURL": "mp.weixin.qq.com",
        "archiveName": null,
        "content": null,
        "articleName": "yhgeOp",
        "articleWordCount": 0,
        "byline": "",
        "cover": "surface/2022111722220619093/98525.jpg",
        "articleURL": null,
        "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
        "archiving": false,
        "starTarget": false,
        "hasMark": true,
        "isRead": null,
        "markCount": null,
        "tags": [],
        "allTags": [],
        "marks": [],
        "groupId": "ff8080817e05ac27017e06c64fed0def",
        "groupName": "",
        "createTime": "2022-11-17T22:22:06:944+08:00",
        "updateTime": "2022-11-18T23:30:40:924+08:00",
        "status": "normal",
        "finished": null,
        "inBlackOrWhiteList": null,
        "type": 0	# 卡片类型，0 为文章
      }
    }
  ],
  "pageCount": 3,	# 总共几页
  "totalCounts": 135	# 总共有几条高亮
}
​

导出操作

导出文件

请求类型：POST 请求

请求链接：https://cubox.pro/c/api/search_engines/export/text

请求体：

engineIds=卡片的ID&type=导出类型&snap=false

  • engineIds：卡片的 ID

  • type：导出的类型

    • 纯文本：text
    • HTML：html
    • MarkDown：md

返回值：

{
  "message": "",
  "code": 200,
  "data": "导出内容"
}
​
  • Cubox
    1 引用 • 3 回帖 • 1 关注
2 操作
mdzz2048 在 2023-05-11 19:24:13 更新了该帖
mdzz2048 在 2022-11-15 23:01:03 更新了该帖
上海 位置
2 感谢
1 关注
3 收藏
1 赞同
2 操作
2 回帖
683 159 125 185 4 8 202

相关帖子

2 回帖
Cubox 部分网页接口

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册 关于
请输入回帖内容 ...
mdzz2048
自己动手，丰衣足食 上海
回帖
158
 帖子
52
 积分
19186