海角社区

GET /api/haijiao/domain 累计调用 0 次

今日域名

获取源站当日公布的大陆可访问域名（含备用 / 海外 / 影视站域名与客服邮箱）。

返回 data.domain（今日大陆可直接访问域名，即源站首页弹窗「今日大陆直接访问网址为: xxx」提示的那个）、data.backup_domain（备用域名）、data.abroad_domain（海外永久域名，需海外网络环境）、data.movie_domain（影视站域名）与 data.customer_service（客服邮箱）——手上的域名失效时可发邮件向客服索取最新域名。
源站的大陆可访问域名每日变动：本服务已自动跟随当日域名，所有海角接口都指向当天可用的域名，调用方无需自行更换地址；本接口供外部系统（自建反代 / 书签 / 公告）查询当前域名。
结果为服务端缓存值（默认 30 分钟），无需频繁调用；源站全部入口都探测不到时返回 EXTERNAL_API_FAILED。

GET /api/haijiao/topics 累计调用 25 次

内容列表

按栏目获取社区内容列表，支持分页。

栏目

可选：栏目，默认 hot（热帖）。

页码

可选：页码，从 1 开始，默认 1（源站每页 20 条）。

返回 data.tab（当前栏目）、data.results（帖子列表）与 data.pagination（分页信息：page / page_size / total / total_page）。
每条帖子含 topic_id、title、excerpt、node（板块）、tags（标签）、author（作者）、images（配图）、has_video、money_type、view_count / comment_count / like_count、create_time、last_comment_time。
tab 非法返回 PARAM_VALUE_INVALID；page 非整数返回 PARAM_FORMAT_ERROR，小于 1 返回 PARAM_VALUE_INVALID。
配图解密（重要）：
images 返回的是源站「混淆地址」，形如 https://pic.xxx.top/hjstore/images/…/<hash>_mini.jpg.txt，直接当图片引用只会拿到一段文本，必须先解密。
解密步骤：① 请求该 .txt 地址，得到文本内容；② 去掉文本中所有不属于解码字母表的字符（只保留 A-Za-z0-9 与 * #，等号等一律丢弃）；③ 用字母表 "ABCD*EFGHIJKLMNOPQRSTUVWX#YZabcdefghijklmnopqrstuvwxyz1234567890" 按下标取 6bit 值，每 4 个字符还原为 3 字节（末尾不足 4 个字符时按下标 0 即 A 补足）；④ 还原出的字节序列按 UTF-8 解码，得到形如 data:image/jpeg;base64,… 的 data URI，即为图片本身。
说明：列表接口下发的是缩略图（文件名带 _mini）；正文原图需「帖子详情」，本期暂未开放。

GET /api/haijiao/search 累计调用 0 次

搜索

按关键词搜索帖子，支持分页与板块筛选。

搜索关键词 *

必填：搜索关键词。

搜索范围

可选：搜索范围，目前仅支持 1（帖子），默认 1。

板块 ID

可选：限定板块 ID，0 表示不限板块（板块 ID 见列表结果 results[].node.id），默认 0。

页码

可选：页码，从 1 开始，默认 1（源站每页 20 条）。

返回 data.key / data.node_id / data.results（帖子列表，字段与「内容列表」一致）与 data.pagination（分页信息：page / page_size / total / total_page）。
key 缺失返回 PARAM_MISSING；type 非 1 返回 PARAM_VALUE_INVALID；node_id 非整数返回 PARAM_FORMAT_ERROR、小于 0 返回 PARAM_VALUE_INVALID；page 非整数返回 PARAM_FORMAT_ERROR、小于 1 返回 PARAM_VALUE_INVALID。
无匹配结果时 data.results 为空数组，不报错。
配图解密（重要，图片字段与内容列表同源）：
images 返回的是源站「混淆地址」，形如 https://pic.xxx.top/hjstore/images/…/<hash>_mini.jpg.txt，直接当图片引用只会拿到一段文本，必须先解密。
解密步骤：① 请求该 .txt 地址，得到文本内容；② 去掉文本中所有不属于解码字母表的字符（只保留 A-Za-z0-9 与 * #，等号等一律丢弃）；③ 用字母表 "ABCD*EFGHIJKLMNOPQRSTUVWX#YZabcdefghijklmnopqrstuvwxyz1234567890" 按下标取 6bit 值，每 4 个字符还原为 3 字节（末尾不足 4 个字符时按下标 0 即 A 补足）；④ 还原出的字节序列按 UTF-8 解码，得到形如 data:image/jpeg;base64,… 的 data URI，即为图片本身。
说明：列表接口下发的是缩略图（文件名带 _mini）；正文原图需「帖子详情」，本期暂未开放。

GET /api/haijiao/topic/detail 累计调用 188 次

帖子详情

获取单个帖子的详情：正文、原图、视频附件、互动数据与相关推荐。

帖子 ID *

必填：帖子 ID（取自「内容列表」的 results[].topic_id）。

登录账号 ID

可选：用自己的账号 ID 覆盖默认凭据（需与 user_token 成对），用于获取视频等需登录态的内容。

登录 Token

可选：与 user_id 成对提供。注意 token 走查询串会留在访问日志，请酌情使用。

返回 data 含：topic_id / title / excerpt / node / tags / author / content（正文 HTML）/ images（原图地址）/ videos（视频附件）/ has_video / 互动数据 / 时间 / related（相关推荐）。
content 为源站正文 HTML（原样返回）：其中 <img> 指向混淆图片地址、<video> 的 src 为空占位。图片请优先用 data.images，正文 HTML 未做改写。
视频：videos[].url 是源站原始 m3u8，不能直接播放（源站密钥是假的，标准播放器会因分片解密失败报 fragParsingError），且随登录态下发（匿名时为空串）。请改用 videos[].play_url —— 那是本服务的「视频播放列表」接口，已还原真密钥，可直接喂给 hls.js 等播放器。
图片同理：images 里的加密地址可交给本服务的「图片解码」接口，直接得到真实图片（见该接口的说明）。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；user_id / user_token 只传其一返回 PARAM_MISSING；帖子不存在返回 EXTERNAL_API_FAILED。
作者头像（author.avatar / avatar_encrypted）说明：
配图解密（重要）：
头像字段（author.avatar / results[].avatar）有两种形态，服务端都已按源站规则补成完整地址，并额外给出 avatar_encrypted 标明该地址能否直接当图片用：
① 用站点默认头像的用户，源站只给 0~80 的编号 → 已补成 https://dbaa49fb2c7091.top/images/common/avatar/<编号>.jpg，avatar_encrypted=false，可直接 <img src>；
② 用户自定义头像，源站给的是混淆地址（形如 …/<hash>.txt，与帖内图片同一套）→ avatar_encrypted=true，把该地址当 url 传给本服务的「图片解码」接口即可拿到真实图片。
images 返回的是源站「混淆地址」，形如 https://pic.xxx.top/hjstore/images/…/<hash>_mini.jpg.txt，直接当图片引用只会拿到一段文本，必须先解密。
解密步骤：① 请求该 .txt 地址，得到文本内容；② 去掉文本中所有不属于解码字母表的字符（只保留 A-Za-z0-9 与 * #，等号等一律丢弃）；③ 用字母表 "ABCD*EFGHIJKLMNOPQRSTUVWX#YZabcdefghijklmnopqrstuvwxyz1234567890" 按下标取 6bit 值，每 4 个字符还原为 3 字节（末尾不足 4 个字符时按下标 0 即 A 补足）；④ 还原出的字节序列按 UTF-8 解码，得到形如 data:image/jpeg;base64,… 的 data URI，即为图片本身。
说明：列表接口下发的是缩略图（文件名带 _mini）；正文原图需「帖子详情」，本期暂未开放。

GET /api/haijiao/topic/comments 累计调用 190 次

帖子评论列表

分页获取帖子的评论（按楼层倒序，最新在前），可按「只看楼主」筛选。

帖子 ID *

必填：帖子 ID（取自「内容列表」的 results[].topic_id）。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

筛选

选填：与源站评论区的「看全部 / 看楼主」两个 tab 一致。

返回 data：topic_id / search_type / pagination（page、page_size、total、total_page）/ results（评论数组）。
按楼层倒序返回（最新评论在前），源站每页 20 条。
results[] 字段：comment_id、floor（楼层）、content（纯文本正文）、images（配图加密地址）、author（id / nickname / avatar / avatar_encrypted / vip / famous / certified）、like_count、liked（我是否点过赞）、reply_count（子评论总数）、replies（源站随本条内联下发的子评论，只作预览）、create_time / pretty_time。
content 已由服务端去掉全部 HTML 标签（源站下发的是 <html><body><p>…</p></body></html> 形式的富文本）：只留可读文字，块级标签与 <br> 转成换行，HTML 实体已还原。因此正文里的图片位置信息不再保留——配图请用同一条的 images 字段（源站混淆地址，形如 …/<hash>.jpg.txt，与帖内配图同一套），交给本服务的「图片解码」接口即可得到真实图片。
需要某条主评论下的完整子评论列表（可翻页）时，用「二级评论」接口（comment_id 取本接口结果里的 comment_id）。
本接口按调用方登录态返回 liked；匿名调用时恒为 false（默认凭据见服务说明）。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；search_type 非 0 / 1 返回 PARAM_VALUE_INVALID；帖子不存在返回 EXTERNAL_API_FAILED。
作者头像（author.avatar / avatar_encrypted）说明：
头像字段（author.avatar / results[].avatar）有两种形态，服务端都已按源站规则补成完整地址，并额外给出 avatar_encrypted 标明该地址能否直接当图片用：
① 用站点默认头像的用户，源站只给 0~80 的编号 → 已补成 https://dbaa49fb2c7091.top/images/common/avatar/<编号>.jpg，avatar_encrypted=false，可直接 <img src>；
② 用户自定义头像，源站给的是混淆地址（形如 …/<hash>.txt，与帖内图片同一套）→ avatar_encrypted=true，把该地址当 url 传给本服务的「图片解码」接口即可拿到真实图片。

GET /api/haijiao/comment/replies 累计调用 0 次

二级评论列表

分页获取某条主评论下的二级评论（子评论）。

主评论 ID *

必填：主评论 ID（取自「帖子评论列表」的 results[].comment_id）。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

源站里子评论是单独接口（按主评论 ID 查），主评论列表里内联的 replies 只适合预览；要看完整 / 翻页子评论用本接口。
返回 data：comment_id（主评论 ID）/ pagination（page、page_size、total、total_page）/ results（子评论数组）。
results[] 字段：comment_id（本条评论 ID）、root_comment_id（所属主评论 ID）、parent_comment_id（直接回复的那条评论 ID，0 表示直接回复主评论，即标准「二级评论」）、author（id / nickname / avatar / avatar_encrypted / vip / famous / certified）、content（纯文本）、quote（被引用的内容，通常为空）、like_count、liked、reply_count（本条自己的子回复数）、last_replies（源站内联的最新一条子回复预览）、create_time / pretty_time。
返回的是扁平列表：同一主评论下的各层级混在一起，层级关系靠 root_comment_id / parent_comment_id 两个 ID 自行组装（源站不做树形返回）。
源站字段里另有 title（用户头衔对象）等展示信息，与业务无关，未收录。
comment_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；源站异常返回 EXTERNAL_API_FAILED。
作者头像（author.avatar / avatar_encrypted）说明：
头像字段（author.avatar / results[].avatar）有两种形态，服务端都已按源站规则补成完整地址，并额外给出 avatar_encrypted 标明该地址能否直接当图片用：
① 用站点默认头像的用户，源站只给 0~80 的编号 → 已补成 https://dbaa49fb2c7091.top/images/common/avatar/<编号>.jpg，avatar_encrypted=false，可直接 <img src>；
② 用户自定义头像，源站给的是混淆地址（形如 …/<hash>.txt，与帖内图片同一套）→ avatar_encrypted=true，把该地址当 url 传给本服务的「图片解码」接口即可拿到真实图片。

GET /api/haijiao/topic/nodes 累计调用 3 次

板块列表

获取发帖可选板块（按层级返回 children，供联动选择）。

无参数：返回 data.list 为顶层板块数组，每个板块含 node_id / name / icon / description / vip_limit / display / children（子板块同结构，可嵌套多层）。
发帖时传所选叶子板块的 node_id（见「发帖」接口）。
板块属站点级公共数据，服务端缓存，变更不频繁。

GET /api/haijiao/topic/tags 累计调用 0 次

标签池

分页获取发帖可选标签（源站标签池，每页 20 条，最新在前）。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

返回 data.pagination 与 data.results（每项 tag_id / tag_name）。
源站该接口不支持关键词搜索（前端只在已加载的一页里本地过滤），只能翻页；调用方若需要搜索，可在本页结果里自行过滤，或直接用标签名发帖。
发帖的 tags 参数传标签名（不是 tag_id）：不在池中的名称会被源站当作新标签，因此自定义标签直接写名称即可。
page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID。

POST /api/haijiao/topic/upload 累计调用 0 次

上传发帖媒体

上传发帖用的图片 / 视频，返回附件 ID 与可直接嵌入正文的 HTML 片段。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

媒体文件 *

必填：图片（png/jpg/jpeg/gif/bmp，单张 ≤10MB）或视频（mp4）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

本接口是 multipart/form-data，文件字段名为 file（页面在线调试可直接选文件）。
源站把图片与视频放在同一个上传接口，靠返回的 category 区分类型（images / video）。
返回 data.html 就是可直接拼进发帖 content 的片段：图片为 <img src="真实地址" data-id="附件ID"/>，视频为 <video src="" data-id="附件ID"></video>（源站正文里视频只留空 src 占位）。
图片的 data.url 已去掉源站下发的 _mini 缩略图后缀（正文用的是原图地址）；视频没有独立地址，url 为空串。
上传只产生附件、不会自动带进帖子：正文里靠 data-id 关联，未发帖的附件可忽略。
格式不支持 / 图片超过 10MB 返回 PARAM_VALUE_INVALID；未选文件 / 凭据缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）。

POST /api/haijiao/topic/create 累计调用 0 次

发帖

发布帖子（板块 / 标签 / 标题 / 正文 / 图片视频）。

去发帖页发布

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

板块 ID *

必填：板块 ID（取自「板块列表」的叶子节点 node_id）。

标题 *

必填：标题，源站上限 36 字。

正文 *

必填：正文 HTML；图片 / 视频片段用「上传发帖媒体」返回的 data.html 拼接。

标签 *

必填：标签名，多个用英文（或中文）逗号分隔；不存在的名称会被源站当作新标签。

帖子类型

选填：默认普通贴。

货币类型

选填：仅出售 / 悬赏有意义。

价格 / 悬赏金额

选填：默认 0；源站前端对金币按 ×100 换算（服务端已同口径处理）。

悬赏时长

选填：仅悬赏贴，需 72-240 的整数。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

发布必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
源站对所有新帖走人工审核：提交成功时返回 data.pending=true 且 data.topic_id 通常为空，此时源站前端提示「发布成功，待审核通过后便可查看」——这不是失败。审核通过后 topic_id 才是可访问的帖子 ID（/post/details?pid=<topic_id>）。
源站有发帖频率风控：短时间内重复发帖会直接失败并提示「请勿灌水，耐心等待4分钟再操作吧」，请控制频率。
发布前服务端会按源站前端的做法先查询一次人机验证：若源站要求验证（滑块拼图），接口会直接返回错误——滑块必须人工完成，本服务无法代过，请换账号或稍后重试。
正文里的图片 / 视频必须先用「上传发帖媒体」上传并拿到 data.html 片段再拼进来；只写 <img> 而没有对应 attachment 不会生效。
node_id / title / content / tags 缺失返回 PARAM_MISSING；title 超过 36 字、type 不在 0-2、reward_hours 不在 72-240 等返回 PARAM_VALUE_INVALID；账号不存在返回 NOT_FOUND（20030）。

GET /api/haijiao/topic/mine 累计调用 0 次

我的帖子

查看自己账号的帖子：发布成功 / 审核中 / 审核失败（含审核失败原因）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

审核状态

选填：与源站「我的帖子」页三个 tab 一致。

页码

选填：从 1 开始，默认 1（源站每页 10 条）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data.status（语义化取值）、data.pagination（page / page_size / total / total_page）与 data.results（帖子数组）。
results[] 字段与「内容列表」基本一致（topic_id / title / excerpt / node / tags / author / images / 互动数据 / 时间），另加：pending_id（待审 ID）、source_status（源站状态码）、remarks（审核失败原因）、has_pic / has_video / has_audio、is_top / is_cream / is_original。
三种状态的区别：published 与 pending 的条目有 topic_id，可拼成 https://dbaa49fb2c7091.top/post/details?pid=<topic_id>；rejected 的条目 topic_id 为空、只有 pending_id，失败原因见 remarks（源站人工审核给的说明）。
源站状态码对应关系：published=3 / pending=2 / rejected=4（服务端已转换，调用方无需关心）。
status 非三种取值返回 PARAM_VALUE_INVALID；page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）。

GET /api/haijiao/gift/list 累计调用 12 次

礼物列表

打赏可选的礼物清单（金币 / 钻石礼物），含各自价格。

礼物面板点选礼物即把它的 item_id 填进下方表单；价格为单个礼物的花费，数量见 quantity。

礼物类型

选填：与源站打赏弹窗的两个 tab 一一对应。

页码

选填：从 1 开始，默认 1。

礼物是站点级公共数据，无需登录；一次取回该类型全部礼物（源站礼物很少）。
返回 data：kind / pagination（page、page_size、total、total_page）/ results。
results[] 字段：item_id（礼物 ID，打赏时传它）、name、desc、kind、money_type（1=金币 2=钻石）、price（原价）、sale_price（实际单价）、img、expire_time、vip_limit。
实际花费 = sale_price × 赠送数量（源站前端同样按 sale_price 计费）。
当前金币礼物里最便宜的是 item_id=1「棒棒糖」（5 金币）。
kind 非两种取值返回 PARAM_VALUE_INVALID；page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID。

GET /api/haijiao/topic/give 累计调用 0 次

给帖子送金币（打赏）

给帖子的作者赠送一份礼物（默认最便宜的那个），即站点的「打赏」。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

礼物面板点选礼物即把它的 item_id 填进下方表单；价格为单个礼物的花费，数量见 quantity。

帖子 ID *

必填：帖子 ID（取自「内容列表」/「帖子详情」的 topic_id）。

礼物 ID

选填：取自「礼物列表」的 item_id；不传则自动选该类型里最便宜的礼物。

赠送数量

选填：默认 1、最大 99；实际花费 = 礼物单价 × 数量。

礼物类型

选填：与源站打赏弹窗的两个 tab 一一对应。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

收礼人 = 帖子作者（源站打赏弹窗传的就是作者的用户 ID），服务端自动解析，调用方只需给帖子 ID。
礼物是「现买现送」：账号不需要事先拥有该礼物，直接按单价扣金币 / 钻石。
会真实扣费：每次调用都会花掉 total_cost 个金币 / 钻石，同一帖子可重复打赏，请确认后再调。
必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：topic_id / item（所赠礼物）/ quantity / total_cost（本次花费）/ receiver（收礼的作者 user_id、nickname）/ money（赠送后余额）。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；quantity 非数字 / 小于 1 / 大于 99 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；帖子不存在、礼物不存在、金币不足等源站拒绝返回 EXTERNAL_API_FAILED（以错误消息区分）。

GET /api/haijiao/user/follow 累计调用 0 次

关注 / 取消关注用户

关注某个用户，或取消对 TA 的关注（相当于个人主页的「关注」按钮）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

目标用户ID *

必填：目标用户 ID，即个人主页地址里的那段数字（https://dbaa49fb2c7091.top/homepage/<user_id>）。

动作

选填：关注按钮的两种状态。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起关注的账号（注意不是目标用户），与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：target_user_id / action（follow / unfollow）/ followed（操作后的关注状态）。
源站成功时只回状态（没有数据体），因此返回里没有对方的昵称等信息。
不能关注自己；重复关注会失败（错误消息「你已关注此用户」），取关未关注的用户同样失败（「用户并未关注被取消的用户」），都返回 EXTERNAL_API_FAILED。
target_user_id 缺失返回 PARAM_MISSING、非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；action 非两种取值返回 PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）。

POST /api/haijiao/user/follow/batch 累计调用 0 次

批量关注 / 取消关注

让账号库里全部账号，都对同一个目标用户执行关注（或取关）。

目标用户ID *

必填：目标用户 ID，即个人主页地址里的那段数字（https://dbaa49fb2c7091.top/homepage/<user_id>）。

动作

选填：对全部账号执行的动作。

不用传凭据：直接用账号库里每个账号自己的登录态执行，遍历范围是全部库内账号。
没有 token 的账号（无法登录）与「目标就是该账号自己」的账号都计入 skipped 并注明原因，不发起请求。
逐个串行执行、不并发；单个账号失败不影响其它账号。整批比较慢，请把客户端超时留够：单次关注请求实测 1.7~2.7 秒，10 个以上账号整体约 20~30 秒。
已经是目标状态（已关注 / 本来就没关注）计入 already，不记为失败。
返回 data：target_user_id / action / total / success_count / already_count / skipped_count / failed_count / items（逐账号的 account_id、user_id、username、state（done / already / skipped / failed）、message）。
风控提醒：一次让大量账号关注同一目标属于明显异常行为，源站可能限制甚至封号，请自行控制频率；需要更保守可改用「关注 / 取消关注用户」逐个、间隔执行。
target_user_id 缺失返回 PARAM_MISSING、非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；action 非两种取值返回 PARAM_VALUE_INVALID。

GET /api/haijiao/ranking 累计调用 3 次

排行榜

首页排行榜：粉丝榜 / 点赞榜 / 人气榜，每个榜单另有总榜 / 月榜 / 周榜。

榜单维度

选填：与源站首页排行榜的 tab 一一对应。

榜单周期

选填：榜单统计的时间范围。

公开数据、无需登录；源站一次返回整张榜单、不翻页（实测粉丝 / 点赞 / 人气榜约 101 条，冷门维度与周榜可能更少）。
返回 data：board / board_label / period / period_label / total / results。
results[] 字段：rank（名次）、user_id、nickname、avatar（头像地址）、avatar_encrypted（该头像是否需要解码）、vip / famous / certified、value（该榜单的数值：粉丝数 / 点赞数 / 人气值）、title（用户头衔：id / name / icon）。
每位用户的主页地址为 https://dbaa49fb2c7091.top/homepage/<user_id>，需要看 TA 的帖子可用「关注 / 取消关注用户」同款的用户 ID。
源站首页排行榜还有消费榜（consume），本服务未开放。
board、period 传入约定外的取值都返回 PARAM_VALUE_INVALID（20003）。
头像说明：
头像字段（author.avatar / results[].avatar）有两种形态，服务端都已按源站规则补成完整地址，并额外给出 avatar_encrypted 标明该地址能否直接当图片用：
① 用站点默认头像的用户，源站只给 0~80 的编号 → 已补成 https://dbaa49fb2c7091.top/images/common/avatar/<编号>.jpg，avatar_encrypted=false，可直接 <img src>；
② 用户自定义头像，源站给的是混淆地址（形如 …/<hash>.txt，与帖内图片同一套）→ avatar_encrypted=true，把该地址当 url 传给本服务的「图片解码」接口即可拿到真实图片。

GET /api/haijiao/user/info 累计调用 0 次

用户主页信息

按用户 ID 查一个人的主页信息：昵称、头像、签名、发帖数、粉丝数、我是否已关注。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

目标用户ID *

必填：目标用户 ID（个人主页 /homepage/<user_id> 里的数字）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

查别人主页不需要登录；但 is_followed（我是否已关注 TA）跟着调用方账号走，不带凭据时恒为 false。
返回 data：user_id / nickname / avatar / avatar_encrypted / description（个性签名）/ fans_count（粉丝数）/ vip / famous / certified / is_followed / topic_count（发帖数）/ video_count / comment_count / favorite_count / like_count。
排行榜、评论、帖子详情里都只有 user_id 和昵称，想了解「这个人是谁」就用本接口。
配合「关注 / 取消关注用户」可完成「查人 → 关注」的闭环。
target_user_id 缺失返回 PARAM_MISSING、非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；用户不存在返回 EXTERNAL_API_FAILED。
头像说明（author.avatar / results[].avatar）：
头像字段（author.avatar / results[].avatar）有两种形态，服务端都已按源站规则补成完整地址，并额外给出 avatar_encrypted 标明该地址能否直接当图片用：
① 用站点默认头像的用户，源站只给 0~80 的编号 → 已补成 https://dbaa49fb2c7091.top/images/common/avatar/<编号>.jpg，avatar_encrypted=false，可直接 <img src>；
② 用户自定义头像，源站给的是混淆地址（形如 …/<hash>.txt，与帖内图片同一套）→ avatar_encrypted=true，把该地址当 url 传给本服务的「图片解码」接口即可拿到真实图片。

GET /api/haijiao/user/wealth 累计调用 0 次

账号余额

查当前账号的金币 / 钻石余额（打赏、签到的配套）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：gold（金币）/ diamond（钻石）。
打赏（给帖子送金币）前可先用本接口确认余额够不够，避免提交后才被源站拒绝。
凭据缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）。

GET /api/haijiao/user/wealth/log 累计调用 0 次

金币 / 钻石流水

查当前账号的金币 / 钻石收支流水（分页，最新在前）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

流水类型

选填：金币与钻石是两套流水。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：kind / pagination（page、page_size、total、total_page）/ results。
results[] 字段：amount（正数=收入、负数=支出）、balance_after（变动后余额）、time、description（如「购买赠送物品[1-棒棒糖]1件赠送给[…]」「任务:每日签到」）。
打赏 / 签到是否真的到账，用本接口核对最直接。
kind 非两种取值返回 PARAM_VALUE_INVALID；page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING。

GET /api/haijiao/user/following 累计调用 0 次

我关注的人

列出当前账号关注了哪些人（源站一次返回全部、不翻页）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：total / results（用户名片数组）。
results[] 字段与「用户主页信息」一致：user_id / nickname / avatar / avatar_encrypted / description / fans_count / vip / famous / certified / is_followed。
源站不分页，一次全给；关注人数很多时响应会比较大。
提醒：列表项里的 is_followed 实测源站恒返回 false（列表里的人本来就是已关注），别用它做判断；「用户主页信息」里的 is_followed 才可信。
凭据缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）。

GET /api/haijiao/user/fans 累计调用 0 次

我的粉丝

分页列出当前账号的粉丝。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：pagination / results（用户名片数组，字段同「我关注的人」）。
粉丝数可在「用户主页信息」的 fans_count 里直接看到，本接口用来翻具体是谁。
page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING。

GET /api/haijiao/topic/like/state 累计调用 0 次

查询是否已点赞

查当前账号是否已经给某帖子点过赞（点赞前先查，避免重复提交）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

帖子 ID *

必填：帖子 ID。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：topic_id / liked（是否已点赞）。
「点赞 / 取消点赞」是按目标状态提交的，重复点赞不会重复计数，但先查一次可以少发一次无效请求。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；凭据缺失返回 PARAM_MISSING。

POST /api/haijiao/topic/like 累计调用 0 次

点赞 / 取消点赞

给帖子点赞，或取消点赞（源站按「点赞后的目标状态」提交）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

帖子 ID *

必填：帖子 ID。

动作

选填：明确的动作，不是「切换」。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
源站提交的是「点赞后的目标状态」（status=true/false），所以 action 传的是明确动作：传 like 就是确保点赞，传 unlike 就是确保取消，不存在「反着来」的情况。
返回 data：topic_id / action / liked（操作后的状态）。
点赞数变化可在「帖子详情」的 like_count 看到；点赞过的帖子用「我点赞过的帖子」查。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；action 非两种取值返回 PARAM_VALUE_INVALID；帖子不存在返回 EXTERNAL_API_FAILED。

POST /api/haijiao/topic/like/batch 累计调用 0 次

批量点赞 / 取消点赞

让账号库里全部账号，都给同一篇帖子点赞（或取消点赞）。

帖子 ID *

必填：帖子 ID。

动作

选填：对全部账号执行的动作。

不用传凭据：直接用账号库里每个账号自己的登录态执行，遍历范围是全部库内账号。
没有 token 的账号（无法登录）计入 skipped 并注明原因，不发起请求。
逐个串行执行、不并发；单个账号失败不影响其它账号。整批比较慢，请把客户端超时留够（单次点赞请求实测 1.7~2.1 秒）。
已经是目标状态的账号（已点过赞 / 本来就没点赞）计入 already，不记为失败，所以重复调用是安全的。
返回 data：topic_id / action / total / success_count / already_count / skipped_count / failed_count / items（逐账号的 account_id、user_id、username、state（done / already / skipped / failed）、message）。
风控提醒：一次让大量账号给同一篇帖子点赞属于明显的刷赞行为，源站可能限制甚至封号，请自行控制频率；需要更保守就用「点赞 / 取消点赞」逐个执行。
topic_id 缺失返回 PARAM_MISSING、非数字返回 PARAM_FORMAT_ERROR；action 非两种取值返回 PARAM_VALUE_INVALID。

GET /api/haijiao/topic/liked 累计调用 0 次

我点赞过的帖子

分页列出当前账号点过赞的帖子。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：pagination / results（帖子数组，字段与「内容列表」一致）。
page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING。
配图解密（重要）：
images 返回的是源站「混淆地址」，形如 https://pic.xxx.top/hjstore/images/…/<hash>_mini.jpg.txt，直接当图片引用只会拿到一段文本，必须先解密。
解密步骤：① 请求该 .txt 地址，得到文本内容；② 去掉文本中所有不属于解码字母表的字符（只保留 A-Za-z0-9 与 * #，等号等一律丢弃）；③ 用字母表 "ABCD*EFGHIJKLMNOPQRSTUVWX#YZabcdefghijklmnopqrstuvwxyz1234567890" 按下标取 6bit 值，每 4 个字符还原为 3 字节（末尾不足 4 个字符时按下标 0 即 A 补足）；④ 还原出的字节序列按 UTF-8 解码，得到形如 data:image/jpeg;base64,… 的 data URI，即为图片本身。
说明：列表接口下发的是缩略图（文件名带 _mini）；正文原图需「帖子详情」，本期暂未开放。

GET /api/haijiao/favorite/folders 累计调用 0 次

我的收藏夹

列出当前账号的收藏夹（「我的收藏」页左侧那一栏）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：total / results（每个收藏夹含 folder_id / name / count）。
count 是该收藏夹里的帖子数（源站提供）。一个收藏都没有时 results 为空数组。
folder_id 可回填到「我收藏的帖子」按夹筛选。
凭据缺失返回 PARAM_MISSING；源站拒绝（如登录态失效）返回 EXTERNAL_API_FAILED。

GET /api/haijiao/favorite/topics 累计调用 0 次

我收藏的帖子

分页列出当前账号收藏的帖子，可按收藏夹筛选。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

页码

选填：从 1 开始，默认 1（源站每页 20 条）。

收藏夹 ID

选填：取自「我的收藏夹」的 folder_id；不传或传 0 = 全部收藏（跨所有收藏夹，源站语义如此）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：pagination / results（帖子数组，字段与「内容列表」一致）。
folder_id 不传或传 0 时返回全部收藏（跨收藏夹）；传具体收藏夹 ID 才只返回该夹。
page 非数字 / 小于 1 返回 PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；folder_id 非数字返回 PARAM_FORMAT_ERROR、小于 0 返回 PARAM_VALUE_INVALID；凭据缺失返回 PARAM_MISSING。
配图解密（重要）：
images 返回的是源站「混淆地址」，形如 https://pic.xxx.top/hjstore/images/…/<hash>_mini.jpg.txt，直接当图片引用只会拿到一段文本，必须先解密。
解密步骤：① 请求该 .txt 地址，得到文本内容；② 去掉文本中所有不属于解码字母表的字符（只保留 A-Za-z0-9 与 * #，等号等一律丢弃）；③ 用字母表 "ABCD*EFGHIJKLMNOPQRSTUVWX#YZabcdefghijklmnopqrstuvwxyz1234567890" 按下标取 6bit 值，每 4 个字符还原为 3 字节（末尾不足 4 个字符时按下标 0 即 A 补足）；④ 还原出的字节序列按 UTF-8 解码，得到形如 data:image/jpeg;base64,… 的 data URI，即为图片本身。
说明：列表接口下发的是缩略图（文件名带 _mini）；正文原图需「帖子详情」，本期暂未开放。

POST /api/haijiao/favorite/add 累计调用 0 次

收藏帖子

把帖子收藏到指定收藏夹（不传 folder_id 即默认收藏夹）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

帖子 ID *

必填：要收藏的帖子 ID（取自内容列表 results[].topic_id）。

收藏夹 ID

选填：目标收藏夹 ID（取自「我的收藏夹」）；不传或传 0 = 默认收藏夹。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：topic_id / folder_id / action（add）。
重复收藏是安全的：同一帖子重复调用源站仍回成功，无需先查再收藏。
帖子不存在时返回 EXTERNAL_API_FAILED（源站消息「收藏的内容不存在」）。
topic_id 缺失 / 非数字返回 PARAM_MISSING / PARAM_FORMAT_ERROR；folder_id 非数字返回 PARAM_FORMAT_ERROR、小于 0 返回 PARAM_VALUE_INVALID。
收藏结果可用「我的收藏夹」（count 变化）与「我收藏的帖子」核对。

POST /api/haijiao/favorite/delete 累计调用 0 次

取消收藏帖子

取消对某篇帖子的收藏。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

帖子 ID *

必填：要取消收藏的帖子 ID。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：topic_id / action（remove）。
取消未收藏的帖子源站会拒绝（消息「无法删除无效的数据」），返回 EXTERNAL_API_FAILED。
topic_id 缺失 / 非数字返回 PARAM_MISSING / PARAM_FORMAT_ERROR。

POST /api/haijiao/favorite/delete/batch 累计调用 0 次

批量取消收藏

一次取消多篇帖子的收藏（逐条串行，单次最多 50 个）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

帖子 ID 列表 *

必填：帖子 ID，多个用逗号分隔（中英文逗号都可以）；自动去重，单次最多 50 个。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：total / success_count / skipped_count / failed_count / items（items[].state：done=已取消 / skipped=本来就没收藏 / failed=失败）。
服务端逐条串行取消（不是源站的批量提交）：源站的原生批量是「按顺序删、遇到没收藏的就报错中止、已删的不回滚」，会返回「失败但实际删了一半」的误导结果，所以这里改为一条条调，每条结果都是确定的；本来就没收藏的计入 skipped、不算失败。
耗时：逐条串行，单条约 1~2 秒——50 条最坏约 1~2 分钟，请把客户端超时留够；只取消几篇时和「取消收藏帖子」没有区别。
topic_ids 缺失 / 全为空返回 PARAM_MISSING；含非整数项返回 PARAM_FORMAT_ERROR；含小于 1 的项、或超过 50 个返回 PARAM_VALUE_INVALID。

POST /api/haijiao/favorite/folder/add 累计调用 0 次

新建收藏夹

新建一个收藏夹（源站规则：名称 1-12 位字符、不可同名）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

收藏夹名称 *

必填：1-12 位字符（源站限制）；重名会被源站拒绝。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：folder_id / name / count（新建出来的收藏夹，folder_id 可直接用于「收藏帖子」）。
源站限制：名称为 1-12 位字符、不可与已有收藏夹同名（重名返回 RESOURCE_ALREADY_EXISTS）。
⚠️ 源站的名字占用缺陷：收藏夹被删除或改名后，它的旧名字并不会释放——再用同一个名字新建会报「已存在!」。若确实要复用某个名字，请另换一个。
folder_name 缺失返回 PARAM_MISSING；超过 12 位返回 PARAM_VALUE_INVALID（不必等源站拒绝）。
本接口只做「新建」；重命名请用「重命名收藏夹」。

POST /api/haijiao/favorite/folder/rename 累计调用 0 次

重命名收藏夹

给收藏夹改名（源站规则：名称 1-12 位字符、不可同名）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

收藏夹 ID *

必填：要重命名的收藏夹 ID（取自「我的收藏夹」）。

新名称 *

必填：1-12 位字符；不可与已有收藏夹同名（含它自己当前的名字）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：folder_id / name / action（rename）——folder_id 与 name 都是本次请求的值（源站成功后回的那个对象 id 恒为 0，不能拿来用，故不采用）。
只改名字，不影响夹内的帖子（收藏内容不变）。
源站限制：名称 1-12 位字符；与已有收藏夹重名会拒绝（返回 RESOURCE_ALREADY_EXISTS，消息「收藏夹【x】已存在!」）；不可改成保留名「默认收藏夹」（返回 EXTERNAL_API_FAILED）。
收藏夹不存在 / 不属于该账号时拒绝（消息「修改的收藏夹不存在」）。
⚠️ 改完名字不会释放旧名（源站的名字占用缺陷）：改名后想用回旧名字会报「已存在!」。
folder_id 缺失 / 非数字 / 小于 1 返回 PARAM_MISSING / PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID；folder_name 缺失返回 PARAM_MISSING、超过 12 位返回 PARAM_VALUE_INVALID。

POST /api/haijiao/favorite/folder/delete 累计调用 0 次

删除收藏夹

删除一个收藏夹（源站要求夹内为空）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

收藏夹 ID *

必填：要删除的收藏夹 ID（取自「我的收藏夹」）。

库内账号 ID

选填：传「账号列表」返回的 account_id；与 user_id + user_token 二选一。

源站用户ID

选填：发起操作的账号，与 user_token 成对使用。

登录Token

选填：与 user_id 成对使用。

必须带登录态：用 account_id（库内账号），或直传 user_id + user_token。
返回 data：folder_id / action（delete）。
源站要求收藏夹为空：夹内还有帖子时会拒绝（消息「不能删除非空收藏夹」），返回 EXTERNAL_API_FAILED；请先用「取消收藏帖子」清空，或先移到别的夹。
收藏夹不存在或不属于该账号时同样拒绝（消息「无权限操作他人的收藏夹」）。
⚠️ 删掉的名字不会释放（源站的名字占用缺陷）：删除后想再建同名收藏夹会报「已存在!」。
folder_id 缺失 / 非数字 / 小于 1 返回 PARAM_MISSING / PARAM_FORMAT_ERROR / PARAM_VALUE_INVALID。

GET /api/haijiao/image 累计调用 581 次

图片解码

传入加密图片地址，服务端解码后返回真实图片，可直接用于 <img src>。

加密图片地址 *

必填：帖内图片的加密地址（取自内容列表 / 详情接口的 images 字段，形如 …/<hash>_mini.jpg.txt）。

响应不是 JSON，而是真实图片二进制（Content-Type 为 image/jpeg 等），可直接用于 <img src>，也可下载保存。
该端点已默认设为「开放」（随迁移 0032 落库）：<img> 无法为请求附带签名参数，故不参与签名校验；如需收紧，可在超管控制台「服务策略」里改回「需要签名」。
安全约束：只接受 http/https 公网地址（拒绝内网 / 回环 / 保留地址）、不跟随重定向、单张体积上限 5MB，且校验解码结果必须是图片（data:image/*），否则返回 EXTERNAL_API_FAILED——不能被当作通用网页代理使用。
url 缺失返回 PARAM_MISSING；地址非法返回 PARAM_VALUE_INVALID。
不清楚加密地址怎么解？点上方「解密说明」，里面有完整的原理、步骤与 Python / JS 参考代码。

图片解码预览服务端解码粘贴加密图片地址（形如 …/xxxx_mini.jpg.txt），点“解码并显示”即可看到真实图片。

GET /api/haijiao/video/m3u8 累计调用 8 次

视频播放列表

获取可直接播放的 m3u8（已在服务端还原源站真密钥），供 HLS 播放器直接加载。

帖子 ID *

必填：帖子 ID（取自内容列表 results[].topic_id）。

视频附件 ID *

必填：视频附件 ID（取自详情接口 videos[].id）。

响应不是 JSON，而是 m3u8 播放列表文本（Content-Type: application/vnd.apple.mpegurl），可直接交给 hls.js / DPlayer 播放；视频分片仍来自源站 CDN，本服务不代理分片。
源站对视频做了自定义保护：清单里的密钥是假的，真 AES-128 密钥需源站 WASM 还原。本接口已在服务端完成还原并把真密钥内嵌进清单，播放器无需再取密钥、也无需特殊处理。
需要服务端配置可用的海角登录凭据（.env 的 HAIJIAO_USER_ID / HAIJIAO_USER_TOKEN），否则取不到视频地址，返回 EXTERNAL_API_FAILED。
该端点已默认设为「开放」（随迁移 0031 落库）：它返回播放列表文本，播放器无法为请求附带签名参数，故不参与签名校验；如需收紧，可在超管控制台「服务策略」里改回「需要签名」。
topic_id / attachment_id 缺失返回 PARAM_MISSING，非整数返回 PARAM_FORMAT_ERROR。

POST /api/haijiao/register/captcha 累计调用 6 次

取注册验证码

两步式注册的第一步：取注册验证码图片（供人工识别），可选经 51代理请求。

是否使用代理

可选：源站对注册有 IP 限制。选 true 时经 51代理请求，提交注册会自动复用同一次出口 IP。

返回 data.captcha_token（提交注册时回传）、data.captcha_image（验证码图片，data URI，可直接 <img> 展示给人工识别）、data.expires_in（有效期秒）、data.use_proxy 与 data.proxy（走代理时的出口 IP:端口）。
为什么分两步：源站注册必须填图形验证码，当前先人工识别；后续接入验证码识别即可自动化（本服务已有 ddddocr 线路，但该站点验证码目前识别率不足，先用人工）。
验证码会话有效期 600 秒：期间需完成「提交注册」，超时请重新获取。
use_proxy 仅支持 true / false，非法值返回 PARAM_VALUE_INVALID。
本页下方提供「批量注册」面板：填数量 → 取多张验证码 → 每张图旁输入框逐个填码 →「一键注册」，用户名 / 密码 / 邮箱由服务端自动生成（用户名统一 xy_ 前缀）。

批量注册验证码人工识别填数量 → 取验证码 → 每张图旁填入验证码 → 一键注册（用户名/密码/邮箱由服务端生成；看不清可点验证码图更换一张）

单次最多 20 条

POST /api/haijiao/register 累计调用 0 次

提交注册

两步式注册的第二步：用识别出的验证码提交注册（走代理时自动复用同一出口 IP）。

验证码会话 Token *

必填：上一步「取注册验证码」返回的 captcha_token。

验证码 *

必填：人工识别的验证码（源站要求 4-6 位）。

用户名 *

必填：用户名（源站上限 12 个字符）。

密码 *

必填：密码，源站要求 ≥ 6 位。

邮箱 *

必填：邮箱，需符合邮箱格式。

本表单上方提供「一键填写」按钮：调用「生成注册账号凭据」接口，自动生成并填入用户名 / 邮箱 / 密码（用户名统一 xy_ 前缀、合计 12 位）。
成功返回 data.user_id / username / nickname / email / token（token 为该账号的登录凭证）。
参数缺失返回 PARAM_MISSING；密码不足 6 位返回 PARAM_VALUE_INVALID；验证码会话不存在或已过期返回 PARAM_VALUE_INVALID（需重新取验证码）。
源站拒绝时 msg 为源站原因：「验证码错误」等业务校验不通过返回 PARAM_VALUE_INVALID，「用户名已存在 / 邮箱已被注册」等返回 RESOURCE_ALREADY_EXISTS（20031）。
验证码一次性：无论成功与否，该 captcha_token 都会立即作废。
本接口会在对方站点真实创建账号，请合规使用；如需限制调用方，可在超管控制台「服务策略」把本服务设为「仅白名单项目」可调用。

自动生成用户名 / 邮箱 / 密码并填入上方表单（用户名统一 xy_ 前缀）

POST /api/haijiao/register/credentials 累计调用 2 次

生成注册账号凭据

生成一组注册用的用户名 / 密码 / 邮箱（不注册、不入库），供「一键填写」或自行批量注册使用。

返回 data.username / data.password / data.email。
生成规则：用户名 = xy_ + 9 位随机（小写字母/数字，合计 12 位，符合源站用户名长度上限）；密码 10 位（必含大写/小写/数字）；邮箱 = <用户名>@<6 位随机小写字母>.com。
本接口只生成不注册：需要创建账号请用「提交注册」或「批量注册」。

POST /api/haijiao/register/batch 累计调用 1 次

批量注册

批量注册：按验证码逐条注册，用户名 / 密码 / 邮箱由服务端自动生成，用户名统一 xy_ 前缀。

注册项列表 *

必填：JSON 数组字符串，每项含 captcha_token 与 captcha_code；可另带 username / password / email 覆盖自动生成值。单次上限 20 项。

返回 data.total / success_count / failed_count 与 data.items（逐项结果）：成功项含 username / password / email / user_id / token，失败项含 msg（源站原因）。
每项的 captcha_token 都来自「取注册验证码」的一次调用，需与该次识别的验证码成对使用；提交时会自动复用取码时的出口 IP（走代理时）。
成功注册的账号会自动写入本服务的账号库（见「账号列表」）。
items 缺失返回 PARAM_MISSING；不是合法 JSON 数组返回 PARAM_FORMAT_ERROR；超过 20 项返回 PARAM_VALUE_INVALID。

POST /api/haijiao/login 累计调用 2 次

账号登录

登录海角社区账号，返回可用 token；支持直传账号或按库内账号 ID 登录。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

用户名

选填：与 password 成对使用；与 account_id 二选一。

密码

选填：与 username 成对使用。

库内账号 ID

选填：传「账号列表」返回的 account_id，服务端从账号表取用户名/密码登录，成功后回写最新 token。

两种用法二选一：username + password 直传，或 account_id（库内账号）。
返回 data.token（登录凭证）与 user_id / username / nickname / email。
登录成功后会按源站 user_id 同步库内账号（命中才同步、不新增）：刷新 token，并用源站返回的用户名 / 邮箱 / 昵称覆盖本地资料；库里没有该账号则只返回登录结果。
源站登录签名为 md5(Username + Password + User-Agent)，由服务端自动计算；正常风控下无需图形验证码。
参数缺失返回 PARAM_MISSING；账号不存在返回 NOT_FOUND（20030）；密码错误等校验不通过返回 PARAM_VALUE_INVALID（msg 为源站原因）。

POST /api/haijiao/sign-in 累计调用 0 次

金币签到

每日金币签到（20 金币/天）；支持按库内账号或直传登录凭据。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

库内账号 ID

选填：传「账号列表」返回的 account_id，服务端用该账号的 user_id + token 签到；与直传凭据二选一。

源站用户ID

选填：与 user_token 成对使用，直接签到指定账号（不入库）。

登录Token

选填：与 user_id 成对使用。

原理：源站 POST /api/user/user_sign_in（无请求体），靠登录态请求头鉴权，故本服务用账号表里存的 user_id + token 直接签到。
双重保险 + 每日本地记录：① 先查库内该账号的「最近签到日期」，等于今天即视为今日已签到，直接返回、不发任何源站请求；② 未命中才查源站任务状态，确认可签到后才真正提交；签到成功后把日期记为今天，当天后续调用都走 ①。日期按自然日比较，跨天自动失效，无需定时任务重置。
返回 data.state：signed=本次签到成功（amount 为到账金币）/ already=今天已签到（含「本地记录」/「源站确认」两种来源，见 message）/ closed=签到任务未开放。
参数缺失返回 PARAM_MISSING；库内账号不存在返回 NOT_FOUND（20030）；账号未存 token 时按参数缺失处理。

POST /api/haijiao/sign-in/batch 累计调用 4 次

一键签到全部账号

对账号表里所有已存 token 的账号逐个执行金币签到（一键全签）。

无参数：一键签到「账号列表」里的全部账号。
逐条走与「金币签到」相同的双重保险：今天已签到的账号命中库内记录的「最近签到日期」后不发任何源站请求，因此重复调用很快；只有未签到的账号才会查询源站并提交签到（逐个串行，避免触发源站风控）。
已签到的账号计入 already_count，不算失败。
返回 data.total / success_count（本次新签成功）/ already_count（今天已签）/ failed_count 与 data.items（逐账号结果：account_id / user_id / username / state / amount / msg）。
本接口不修改密码 / token 等账号资料，仅回写各账号的「最近签到日期」，可安全重复调用。

GET /api/haijiao/accounts 累计调用 7 次

账号列表

分页查询已入库的海角社区账号（注册成功会自动入库）。

关键词

选填：模糊匹配用户名 / 邮箱 / 昵称 / 源站用户ID。

页码

选填：默认 1。

每页条数

选填：1-100，默认 10。

返回密码

选填：是否在列表项中携带密码明文，默认 false。

返回 data.total 与 data.items；列表项包含 account_id（UUID）、user_id、username、email、nickname、remark 与 has_password / has_token 标记。
出于安全，列表不回传密码与 token 明文；需要密码请传 with_password=true，需要 token 请查「账号详情」，或直接调「账号登录」（会回写最新 token）。

POST /api/haijiao/accounts 累计调用 7 次

新增账号

手动新增一条账号记录（注册成功也会自动入库，此接口用于补录/导入）。

源站用户ID *

必填：海角社区用户 ID（全局唯一，重复返回 20031）。

用户名 *

必填：用户名。

密码 *

必填：密码（落库 AES 加密）。

邮箱

选填：邮箱。

昵称

选填：昵称。

登录Token

选填：登录凭证（落库 AES 加密）。

备注

选填：备注。

必填项缺失返回 PARAM_MISSING；源站用户 ID 已存在返回 RESOURCE_ALREADY_EXISTS（20031）。

GET /api/haijiao/accounts/<uuid> 累计调用 2 次

账号详情

按账号 ID 查询单条账号（含 token 明文）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

账号 ID *

路径参数：账号 UUID（文档页代调时填入 account_id 即可）

返回密码

选填：是否在返回中携带密码明文，默认 false。

账号不存在返回 NOT_FOUND（20030）。

PATCH /api/haijiao/accounts/<uuid> 累计调用 2 次

更新账号

部分字段更新账号（username / password / email / nickname / token / remark）。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

账号 ID *

路径参数：账号 UUID（文档页代调时填入 account_id 即可）

用户名

选填：置空会被拒绝。

密码

选填：置空会被拒绝。

邮箱

选填。

昵称

选填。

登录Token

选填。

备注

选填。

user_id 是源站身份标识，不可修改；账号不存在返回 NOT_FOUND（20030）。

DELETE /api/haijiao/accounts/<uuid> 累计调用 2 次

删除账号

删除账号记录。

账号选择器搜库内账号输入用户名 / 用户ID / 昵称 / 备注搜索，点一条即自动填入 account_id 与 user_id。

账号 ID *

路径参数：账号 UUID（文档页代调时填入 account_id 即可）

仅删除本服务的记录，不会影响源站账号；账号不存在返回 NOT_FOUND（20030）。

服务说明

海角社区

今日域名

内容列表

搜索

帖子详情

帖子评论列表

二级评论列表

板块列表

标签池

上传发帖媒体

发帖

我的帖子

礼物列表

给帖子送金币（打赏）

关注 / 取消关注用户

批量关注 / 取消关注

排行榜

用户主页信息

账号余额

金币 / 钻石流水

我关注的人

我的粉丝

查询是否已点赞

点赞 / 取消点赞

批量点赞 / 取消点赞

我点赞过的帖子

我的收藏夹

我收藏的帖子

收藏帖子

取消收藏帖子

批量取消收藏

新建收藏夹

重命名收藏夹

删除收藏夹

图片解码

视频播放列表

取注册验证码

提交注册

生成注册账号凭据

批量注册

账号登录

金币签到

一键签到全部账号

账号列表

新增账号

账号详情

更新账号

删除账号