文献泡泡 - 帮助

简体中文

English

简体中文

English

Appearance

API 参考 ​

两个接口的请求格式完全一致，仅返回内容不同。

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

通用请求体 ​

json
{
  "journals": ["J Med Chem", "CLINICAL SOCIAL WORK JOURNAL"]
}
字段类型必填说明
journalsstring[]是期刊名列表，1–20 个，单个名称 ≤ 200 字符，空白项会被忽略

通用响应外层：

字段说明
count本次查询的期刊数
results结果数组，与请求顺序一一对应
usage本次计费与剩余额度信息

查询影响因子 / 分区 ​

POST /dev/impact-factors/

数据来源于互联网公开信息整理。

响应示例 ​

json
{
  "count": 2,
  "results": [
    {
      "query": "J Med Chem",
      "found": true,
      "impact_factor": {
        "JIF": "6.8",
        "JIF5": "7.2",
        "Q": "1",
        "N": "1"
      }
    },
    {
      "query": "CLINICAL SOCIAL WORK JOURNAL",
      "found": true,
      "impact_factor": {
        "JIF": "1.6",
        "JIF5": "2.7",
        "Q": "2",
        "N": "3"
      }
    }
  ],
  "usage": {
    "source": "free",
    "free_used": 1
  }
}

impact_factor 字段 ​

字段说明
JIF最新影响因子
JIF5五年影响因子
QJCR 分区（1–4，对应 Q1–Q4）
N中科院分区（1–4 区）

found: false 表示该刊未被 JCR 收录或名称未匹配。

预警 / 掠夺性期刊检查 ​

POST /dev/warnings/

检查期刊是否命中预警 / 掠夺性期刊名单，目前包含两个来源：

code名称版本说明
warning预警名单2025中国科学院文献情报中心发布，130+ 种期刊
predatoryjournals_org掠夺性期刊2025predatoryjournals.org 发布，约 2800 种期刊

只要命中任一来源，is_warning 即为 true。这是一个布尔安全检查，适合在投稿前或文献条目渲染时标红提示。

响应示例 ​

json
{
  "count": 1,
  "results": [
    {
      "query": "Aerospace",
      "is_warning": true,
      "sources": [
        {
          "code": "warning",
          "name": "预警名单",
          "name_en": "International Journal Early Warning List",
          "version": "2025",
          "desc": "由中国科学院文献情报中心发布，总计130+种期刊",
          "desc_en": "Published by the Institute of Literature and Information of the Chinese Academy of Sciences, ~130+ journals"
        },
        {
          "code": "predatoryjournals_org",
          "name": "掠夺性期刊",
          "name_en": "Predatory Journal",
          "version": "2025",
          "desc": "由 predatoryjournals.org 发布，总计约2800种掠夺性期刊",
          "desc_en": "Published by predatoryjournals.org, ~2800 predatory journals"
        }
      ]
    }
  ],
  "usage": {
    "source": "free",
    "free_used": 5
  }
}

结果字段 ​

字段说明
query原始查询名
is_warning是否命中任一名单（未命中时 sources 为空数组）
sources命中的名单来源数组，可能多个

sources 元素字段 ​

字段说明
code来源标识：warning / predatoryjournals_org
name / name_en来源名称（中 / 英）
version名单版本年份
desc / desc_en来源说明（中 / 英）

客户端只需依据 is_warning 做布尔判断，必要时用 sources 给出具体的警告来源。

相关链接 ​