ISBN查询 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/isbn

请求方式GET,POST

返回格式JSON

调用权限需登录

ApiKey需要

创建时间2026-05-19

脚本路由isbn

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

参数名	必填	类型	说明	示例值
`key`	是	string	需要审核通过的 ApiKey。请注册账号获取API Key。	`YOUR_API_KEY`
`isbn`	是	string	ISBN号码（支持ISBN-10和ISBN-13，可包含连字符）	`9787111532644`
`action`	否	string	操作类型：validate(验证)/info(详细信息)/convert(转换)/format(格式化)，默认info

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求 https://api.ruseo.cn/api/isbn?key=YOUR_API_KEY&isbn=9787111532644&action=demo

cURL

curl "https://api.ruseo.cn/api/isbn?key=YOUR_API_KEY&isbn=9787111532644&action=demo"

PHP

$url = 'https://api.ruseo.cn/api/isbn?key=YOUR_API_KEY&isbn=9787111532644&action=demo';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/isbn?key=YOUR_API_KEY&isbn=9787111532644&action=demo')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "isbn",
        "example": true
    }
}

返回参数说明

参数名	类型	说明
`isbn`	string	输入的ISBN号码
`is_valid`	boolean	ISBN格式是否有效
`isbn10`	boolean	是否为ISBN-10格式
`isbn13`	boolean	是否为ISBN-13格式
`registration_group_valid`	boolean	注册组是否有效
`formatted`	string	格式化后的ISBN（如：978-7-111-12345-6）
`unformatted`	string	无格式ISBN（如：9787111123456）
`parts.prefix`	string	ISBN-13前缀（978或979）
`parts.registration_group`	string	注册组代码（如：7代表中国）
`parts.registrant`	string	出版者代码
`parts.publication`	string	出版序号
`parts.check_digit`	string	校验位
`conversions.to_isbn10`	string	转换为ISBN-10的结果
`conversions.to_isbn13`	string	转换为ISBN-13的结果
`registration_group_info.name`	string	注册组名称（如：中国）
`registration_group_info.countries`	string	注册组对应的国家/地区

调试参数

请求方式接口地址 key * isbn * action

响应结果

◔ --

点击左侧“发送请求”查看结果...