期刊数据开放 API

面向开发者的期刊查询接口，可用于 Zotero 插件、OpenClaw Skill、文献管理工具等二次开发。

提供两类能力：

能力	接口	典型场景
影响因子 / 分区	POST /journals/dev/impact-factors/	Zotero 条目旁显示 IF、JCR 分区、中科院分区
国际期刊预警检查	POST /journals/dev/warnings/	投稿前安全检查，预警期刊标红

详见 API参考文档，或直接 在线测试。

特别说明

• 影响因子 / 分区数据来源于互联网公开信息，不保证完全准确，仅供参考。
• 预警名单由中国科学院文献情报中心发布（2025 版，130+ 种期刊）。
• 数据结果与最新版文献泡泡浏览器扩展保持一致，会定期更新，但不承诺实时同步。
• 开发者应在界面上明确告知用户数据来源与性质，避免误导。

基础信息

• Base URL：https://api.byteslink.cn/journals
• 协议：HTTPS，请求与响应均为 JSON
• 编码：UTF-8

认证

所有 /dev/* 接口使用 API Key 认证，在请求头携带：

X-API-Key: pp_xxxxxxxxxxxxxxxx

• 在网站「用户中心 → 我的API」生成。明文 Key 仅在生成时显示一次，请妥善保存。
• 每个账号同一时间只有一个有效 Key，重新生成即轮换，旧 Key 立即失效。
• Key 无效或未携带返回 401。

计费

• 按请求次数计费：一次请求计 1 次，无论批量查询多少个期刊（单次最多 20 个）。提示：批量查询可以节省额度。😊
• 每日有免费额度，用完后扣付费额度；付费额度单价 0.01 元/次，充值范围 10–999 元（整数元）。
• 免费额度数值与剩余情况以网站「用户中心 → 我的API」页面为准。
• 额度耗尽返回 402 Payment Required。
• 每次成功响应都附带 usage 字段，返回本次扣费来源与剩余额度，可据此在客户端做提醒。

限流

维度	限制
单用户（按 Key）	200 次/分钟
单 IP	500 次/分钟

超限返回 429，建议客户端按 Retry-After 或固定退避重试。

错误码

状态码	含义	说明
400	参数错误	如 journals 为空、超过 20 个
401	认证失败	Key 缺失或无效
402	额度不足	免费 + 付费额度均耗尽
429	触发限流	请降低请求频率

错误响应为 DRF 标准格式，例如：

{ "detail": "无效的 API Key" }

期刊名匹配规则

服务端会对期刊名做规范化匹配，如：

• 大小写不敏感
• 忽略开头冠词（The/A/An）
• & 与 AND 等价，/ 视为空格
• 支持常见期刊缩写（如 J Med Chem）自动映射到全称

未命中时返回 found: false（或 is_warning: false），不会报错。