🔑 API 文档

ISMOMKEY（免费）与 ISMOMSKEY（199 CNY/年）是用于证明账户身份的 API 服务密钥。

① 域名与调用

API 地址：api.xiagoyn.cn（直接解析到本站主机，动作路径直达，无需 /key 前缀），支持两种调用方式：

动作直连（推荐）：api.xiagoyn.cn/<动作>，密钥通过 Authorization: Bearer、X-API-Key 头或 ?key= 携带
密钥路径：api.xiagoyn.cn/<密钥>/<动作>

协议：HTTPS / HTTP，GET / POST 均可；请求体使用 application/json（上传/删除帖子的动作）。

② 两种密钥对比

项目	ISMOMKEY 免费	ISMOMSKEY 199 CNY/年
获取方式	登录网站后自助获取	网站提交申请 → 线下确认收款 → 后台发放
适用用户	所有注册用户	仅限中国注册用户
速率上限（通信单位）	2 M/s	1000 M/s
每秒最大请求次数	2 次	10 次
速度与安全	限速	速度更快、更安全（S 版）

注意：速率为通信单位（非数据存储单位），且是理论最大值。实际传输会因数据包带头、握手、编码等开销而低于标称速度，属正常现象。

③ 密钥格式

ismom.[用户UUID].[64位随机字符] 或 ismoms.[用户UUID].[64位随机字符]（随机段均为 64 位，不区分大小写）

校验不区分大小写（您把密钥写成大写、小写或混合，验证结果一致）；密钥不允许重复，一人一型一把。

④ 认证方式（任选其一）

Authorization: Bearer ismom.xxxxxxxx.xxxx...
X-API-Key: ismom.xxxxxxxx.xxxx...
https://api.xiagoyn.cn/yc_query

最简写法：api.xiagoyn.cn/<动作>（动作直达，域名下不要写 /key），密钥放请求头里即可。

⑤ 可用接口

动作	方法	说明
`key_info`	GET	查询本密钥类型/限速/创建时间
`upload_post`	POST	以本人身份上传帖子（自动进入管理员审核），参数 title/content/cat/zone
`delete_post`	POST	删除本人发布的帖子，参数 post_id（他人帖子一律拒绝）
`yc_query`	GET	查询本人 YAOCOIN（YC）余额，付费货币 0.01 CNY/个
`xc_query`	GET	查询本人 XiaoC（XC）余额，免费获取、多处可用

货币信息不公开，仅密钥本人可查询。

⑥ 请求示例

curl（查询余额）

curl -H "Authorization: Bearer ismom.你的UUID.你的64位随机段"   "https://api.xiagoyn.cn/yc_query"

Python（上传帖子）

import requests
KEY = "ismom.你的UUID.你的64位随机段"
r = requests.post(
    "https://api.xiagoyn.cn/upload_post",
    headers={"Authorization": "Bearer " + KEY},
    json={"title": "我的帖子", "content": "正文内容",
          "cat": "学习与交流", "zone": "学习资料"})
print(r.json())   # {"ok": true, "id": 21, "status": "pending", ...}

JavaScript（查询 XiaoC）

const KEY = "ismom.你的UUID.你的64位随机段";
fetch("https://api.xiagoyn.cn/xc_query", {
  headers: { "X-API-Key": KEY }
}).then(r => r.json()).then(console.log);

⑦ 响应与错误

成功：HTTP 200，{"ok": true, ...}（返回文本为 JSON）。

错误：HTTP 401 密钥无效 · 403 无权操作 · 404 未知动作/帖子不存在 · 429 超出限速（含每秒请求次数限制与流量限制）。

区块（cat）参考：Minecraft / 学习与交流 / 热门游戏 / 电脑与科技 / 生活 / 动漫与影视 / 音乐 / 运动 / 科学与宇宙 / 文学与创作 / 商务与职场 / 社区服务。

⑧ 获取与售后

ISMOMKEY：登录本站后到 /ismomkey/ 自助获取（免费，每用户最多 20 条，可随时添加、查看、删除）。

ISMOMSKEY：199 CNY/年（仅限中国注册用户，商城与支付暂停中，暂不接受新购；请联系站长 x@xiagoyn.cn）；修改注册国家需联系 x@xiagoyn.cn。

密钥请妥善保管，泄露可能导致账户被冒用；可在 /ismomkey/ 自助删除并重新添加。

⑨ API 服务条款 · 2026-10-01 发布

一、使用条款

1. 密钥为账号级凭证，仅限本人使用，禁止转售、共用、出借或代持；一经发现共用/转售，平台有权立即作废密钥并封禁账号。

2. 调用必须遵守各自密钥的速率与频次上限（ISMOMKEY：2 M/s、每秒 2 次；ISMOMSKEY：1000 M/s、每秒 10 次），超过上限将被 429 限速；恶意高频调用将触发自动停止与封禁。

3. 上传/删除帖子的动作仅限操作本人内容；越权操作他人内容一律拒绝并记录。

4. 密钥泄露造成的损失由持钥人自行承担；可在网站自助撤销并重新生成。

二、购买条款（ISMOMSKEY）

1. 价格 199 CNY/年，按年订阅，仅限中国注册用户购买（注册国家不可自行修改，确需修改请联系 x@xiagoyn.cn）。

2. 在线支付（码支付）成功后自动发放密钥；虚拟服务商品，一经发放不支持退款，到期不续费则自动失效。

3. 订阅期内享 1000 M/s 理论最大速率与每秒 10 次请求上限（速率指通信单位，实际会因数据包带头、握手等开销低于标称值，属正常）。

三、货币条款

YC（YAOCOIN）为付费货币，0.01 CNY/个，可查询余额；XC（XiaoC）为免费货币，多处功能通用。货币信息不公开，仅密钥本人可查询。

四、免责与变更

因维护、不可抗力或第三方原因导致的服务中断，平台不承担间接损失；本条款更新时将刷新发布日期并在本站公告，继续使用即视为同意新条款。

🔑 我的 API 密钥