查询
请求Header:
名称 | 值 | |
---|---|---|
Content-Type | application/x-www-form-urlencoded |
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
isbn | 是 | string | 书籍的isbn码 |
请求代码示例:
curl -k -i -d "key=您申请的AppKey&isbn=9787544258975" http://apis.juhe.cn/isbn/query
<?php
$url = "http://apis.juhe.cn/isbn/query";
$params = [
"key" => "您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"isbn" => "9787544258975", # 书籍的isbn码
];
$paramsStr = http_build_query($params);
$headers = ["Content-Type" => "application/x-www-form-urlencoded"];
$content = httpRequest($url, $paramsStr,0,$headers);
$result = json_decode($content, true);
if ($result) {
var_dump($result);
// 具体返回示例值,参考返回参数说明、json返回示例
} else {
// 请求异常
}
/**
*
* 发起请求
* @param $url
* @param string $dataStr
* @param int $isPost
* @return bool|string
*/
function httpRequest($url, $dataStr = "", $isPost = 0,$headers=[])
{
$httpInfo = [];
$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.172 Safari/537.22");
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 请求头
if (!empty($headers)) {
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
}
// 跳过证书检查
if (strtolower(mb_substr($url,0,8,"utf-8")) == "https://") {
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
}
if ($isPost) {
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $dataStr);
curl_setopt($ch, CURLOPT_URL, $url);
} else {
curl_setopt($ch, CURLOPT_URL, $url . "?" . $dataStr);
}
//echo $url."?".$dataStr;
$response = curl_exec($ch);
if ($response === false) {
//echo "cURL Error: " . curl_error($ch);
return false;
}
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$httpInfo = array_merge($httpInfo, curl_getinfo($ch));
curl_close($ch);
return $response;
}
#!/usr/bin/python3
# -*- coding: utf-8 -*-
import requests
import json
headers ={"Content-Type": "application/x-www-form-urlencoded"}
url = "http://apis.juhe.cn/isbn/query"
params = {
"key":"您申请的AppKey", # 在个人中心->我的数据,接口名称上方查看
"isbn":"9787544258975", # 书籍的isbn码
}
resp = requests.get(url,params,headers=headers)
resp_json = json.loads(resp.text)
print(resp_json)
# 具体返回示例值,参考返回参数说明、json返回示例
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"strings"
"time"
)
func main() {
// 接口请求地址
url := "http://apis.juhe.cn/isbn/query"
// 接口请求参数
params := map[string]string{
"key":"您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
"isbn":"9787544258975", // 书籍的isbn码
}
// 请求头设置
headers := map[string]string{
"Content-Type": "application/x-www-form-urlencoded",
}
response, err := HttpRequest("GET", url, params, headers, 15)
if err != nil {
fmt.Println("请求异常:", err.Error())
} else {
fmt.Println("请求结果:", response)
}
// 具体返回示例值,参考返回参数说明、json返回示例
}
// http请求发送
func HttpRequest(method, rawUrl string, bodyMaps, headers map[string]string, timeout time.Duration) (result string, err error) {
var (
request *http.Request
response *http.Response
res []byte
)
if timeout <= 0 {
timeout = 5
}
client := &http.Client{
Timeout: timeout * time.Second,
}
// 请求的 body 内容
data := url.Values{}
for key, value := range bodyMaps {
data.Set(key, value)
}
jsons := data.Encode()
if request, err = http.NewRequest(method, rawUrl, strings.NewReader(jsons)); err != nil {
return
}
if method == "GET" {
request.URL.RawQuery = jsons
}
// 增加header头信息
for key, val := range headers {
request.Header.Set(key, val)
}
// 处理返回结果
if response, err = client.Do(request); err != nil {
return "", err
}
defer response.Body.Close()
if res, err = io.ReadAll(response.Body); err != nil {
return "", err
}
return string(res), nil
}
//node request模块安装命令:npm install request
var request = require("request");
var querystring = require("querystring");
const options = {
url: "http://apis.juhe.cn/isbn/query",
method: "GET", // GET|POST
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
// GET 传递此参数
qs:{
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
isbn: "9787544258975", // 书籍的isbn码
},
// POST 传递此参数
body: querystring.stringify({
key: "您申请的AppKey", // 在个人中心->我的数据,接口名称上方查看
isbn: "9787544258975", // 书籍的isbn码
})
};
request(options, function (error, response, body) {
if (!error && response.statusCode == 200) {
console.log(body); // 请求成功,输出响应内容
// 具体返回示例值,参考返回参数说明、json返回示例
} else {
console.log("请求异常");
}
});
import net.sf.json.JSONObject;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util.Map;
import java.util.HashMap;
public class ApiDemo {
public static void main(String[] args) {
// 发送http请求的url
String url = "http://apis.juhe.cn/isbn/query";
Map<String, String> params = new HashMap<String, String>();
params.put("key", "您申请的AppKey"); // 在个人中心->我的数据,接口名称上方查看
params.put("isbn", "9787544258975"); // 书籍的isbn码
String paramsStr = urlencode(params);
System.out.println(paramsStr);
String response = doGet(url,paramsStr);
// // post请求
// String response = doPost(url,paramsStr);
// 输出请求结果
System.out.println(response);
try {
// 解析请求结果,json:
JSONObject jsonObject = JSONObject.fromObject(response);
System.out.println(jsonObject);
// 具体返回示例值,参考返回参数说明、json返回示例
} catch (Exception e) {
e.printStackTrace();
}
}
// 将map型转为请求参数型
public static String urlencode(Map<String, String> data) {
StringBuilder sb = new StringBuilder();
for (Map.Entry i : data.entrySet()) {
try {
sb.append(i.getKey()).append("=").append(URLEncoder.encode(i.getValue() + "", "UTF-8")).append("&");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
return sb.toString();
}
/**
* get方式的http请求
*
* @param httpUrl 请求地址
* @param paramStr 请求参数
* @return 返回结果
*/
public static String doGet(String httpUrl,String paramStr) {
HttpURLConnection connection = null;
InputStream inputStream = null;
BufferedReader bufferedReader = null;
String result = null;// 返回结果字符串
try {
httpUrl += "?"+paramStr;
// 创建远程url连接对象
URL url = new URL(httpUrl);
// 通过远程url连接对象打开一个连接,强转成httpURLConnection类
connection = (HttpURLConnection) url.openConnection();
// 设置连接方式:get
connection.setRequestMethod("GET");
// 设置连接主机服务器的超时时间:15000毫秒
connection.setConnectTimeout(15000);
// 设置读取远程返回的数据时间:60000毫秒
connection.setReadTimeout(60000);
// 设置请求头
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
// 发送请求
connection.connect();
// 通过connection连接,获取输入流
if (connection.getResponseCode() == 200) {
inputStream = connection.getInputStream();
// 封装输入流,并指定字符集
bufferedReader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
// 存放数据
StringBuilder sbf = new StringBuilder();
String temp;
while ((temp = bufferedReader.readLine()) != null) {
sbf.append(temp);
sbf.append(System.getProperty("line.separator"));
}
result = sbf.toString();
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
// 关闭资源
if (null != bufferedReader) {
try {
bufferedReader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != inputStream) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (connection != null) {
connection.disconnect();// 关闭远程连接
}
}
return result;
}
/**
* post方式的http请求
*
* @param httpUrl 请求地址
* @param paramStr 请求参数
* @return 返回结果
*/
public static String doPost(String httpUrl, String paramStr) {
HttpURLConnection connection = null;
InputStream inputStream = null;
OutputStream outputStream = null;
BufferedReader bufferedReader = null;
String result = null;
try {
URL url = new URL(httpUrl);
// 通过远程url连接对象打开连接
connection = (HttpURLConnection) url.openConnection();
// 设置连接请求方式
connection.setRequestMethod("POST");
// 设置连接主机服务器超时时间:15000毫秒
connection.setConnectTimeout(15000);
// 设置读取主机服务器返回数据超时时间:60000毫秒
connection.setReadTimeout(60000);
// 默认值为:false,当向远程服务器传送数据/写数据时,需要设置为true
connection.setDoOutput(true);
// 设置传入参数的格式:请求参数应该是 name1=value1&name2=value2 的形式。
connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
// 通过连接对象获取一个输出流
outputStream = connection.getOutputStream();
// 通过输出流对象将参数写出去/传输出去,它是通过字节数组写出的
outputStream.write(paramStr.getBytes());
// 通过连接对象获取一个输入流,向远程读取
if (connection.getResponseCode() == 200) {
inputStream = connection.getInputStream();
// 对输入流对象进行包装:charset根据工作项目组的要求来设置
bufferedReader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
StringBuilder sbf = new StringBuilder();
String temp;
// 循环遍历一行一行读取数据
while ((temp = bufferedReader.readLine()) != null) {
sbf.append(temp);
sbf.append(System.getProperty("line.separator"));
}
result = sbf.toString();
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
// 关闭资源
if (null != bufferedReader) {
try {
bufferedReader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != outputStream) {
try {
outputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != inputStream) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (connection != null) {
connection.disconnect();
}
}
return result;
}
}
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | jsonObject | 返回结果集 | |
orderid | string | 属result,聚合订单号 | |
data | jsonObject | 属result,详情信息 | |
series | string | 属data,丛书信息(不是丛书为空字符串) | |
title | string | 属data,书名 | |
author | string | 属data,作者(编者、译者)信息 | |
publisher | string | 属data,出版社 | |
pubDate | string | 属data,出版日期 | |
pubPlace | string | 属data,出版地 | |
isbn | string | 属data,13位isbn号 | |
isbn10 | string | 属data,10位isbn号 | |
price | string | 属data,定价 | |
genus | string | 属data,中图分类号 | |
levelNum | string | 属data,读者评分 | |
heatNum | string | 属data,图书热度(即:购买或评论总人次) | |
format | string | 属data,纸张开数 | |
binding | string | 属data,装帧信息 | |
page | string | 属data,页数 | |
wordNum | string | 属data,字数 | |
edition | string | 属data,版次 | |
yinci | string | 属data,印次 | |
paper | string | 属data,书籍纸张类型 | |
language | string | 属data,语言 | |
keyword | string | 属data,图书关键词 | |
img | string | 属data,封面图片大图链接 | |
smallImg | string | 属data,封面图片小图链接 | |
bookCatalog | string | 属data,目录 | |
gist | string | 属data,图书内容简介 | |
cipTxt | string | 属data,cip信息 | |
annotation | string | 属data,一般附注 | |
subject | string | 属data,主题 | |
batch | string | 属data,丛编信息 |
JSON返回示例:JSON在线格式化工具 >
{
"reason": "成功",
"result": {
"data": {
"series": "",/**丛书信息(不是丛书为空字符串) */
"title": "霍乱时期的爱情",/** */
"author": "[哥伦比亚]加西亚•马尔克斯",/** */
"publisher": "南海出版社",/** 出版社 */
"pubDate": "201209",/**出版日期 */
"pubPlace": "",/** 出版地*/
"isbn": "9787544258975",/**13位isbn号*/
"isbn10": "7544258971",/**10位isbn号*/
"price": "39.50",/**定价*/
"genus": "",/**中图分类号 */
"levelNum": "9.0",/**读者评分*/
"heatNum": "269890",/**图书热度(即:购买或评论总人次)*/
"format": "",/**纸张开数*/
"binding": "精装",/**装帧信息*/
"page": "41",/**页数*/
"wordNum": "",/**字数*/
"edition": "",/**版次*/
"yinci": "",/**印次*/
"paper": "",/**书籍纸张类型*/
"language": "",/**语言*/
"keyword": "|人到中年必须要看的书",/**图书关键词*/
"img": "https://img.maimiaobook.com/cover/Y4AKM6Q3G1.jpg?x-oss-process=style/yuantu",/**封面图片大图链接*/
"smallImg": "https://img.maimiaobook.com/cover/Y4AKM6Q3G1.jpg?x-oss-process=style/suolvetu",/**封面图片小图链接*/
"bookCatalog": "",/**目录*/
"gist": "马尔克斯唯一正式授权,首次完整翻译《霍乱时期的爱情》是我最好的作品,是我发自内心的创作。加西亚马尔克斯这部光芒闪耀、令人心碎的作品是人类有史以来最伟大的爱情小说。《纽约时报》《霍乱时期的爱情》是加西亚马尔克斯获得诺贝尔文学奖之后完成的第一部小说。讲述了一段跨越半个多世纪的爱情史诗,穷尽了所有爱情的可能性:忠贞的、隐秘的、粗暴的、羞怯的、柏拉图式的、放荡的、转瞬即逝的、生死相依的再现了时光的无情流逝,被誉为人类有史以来最伟大的爱情小说,是2世纪最重要的经典文学巨著之一。",/**图书内容简介 */
"cipTxt": "",/**cip信息*/
"annotation": "",/** 一般附注*/
"subject": "",/**主题*/
"batch": ""/**丛编信息*/
},
"orderid": "JH72620221207104255YaG"/** 单号*/
},
"error_code": 0
}
服务级错误码参照(error_code):
错误码 | 说明 | |
---|---|---|
272601 | 数据源超时 | |
272602 | 没有找到相关书籍 | |
272603 | 参数异常 | |
272604 | 调用超限,请稍候再试 | |
272605 | 查询异常 | |
272606 | isbn不能为空 |
系统级错误码参照:
错误码 | 说明 | 旧版本(resultcode) | |
---|---|---|---|
10001 | 错误的请求KEY | 101 | |
10002 | 该KEY无请求权限 | 102 | |
10003 | KEY过期 | 103 | |
10004 | 错误的OPENID | 104 | |
10005 | 应用未审核超时,请提交认证 | 105 | |
10007 | 未知的请求源 | 107 | |
10008 | 被禁止的IP | 108 | |
10009 | 被禁止的KEY | 109 | |
10011 | 当前IP请求超过限制 | 111 | |
10012 | 请求超过次数限制 | 112 | |
10013 | 测试KEY超过请求限制 | 113 | |
10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | 114 | |
10020 | 接口维护 | 120 | |
10021 | 接口停用 | 121 |
错误码格式说明(示例:200201):
2 | 002 | 01 | |
---|---|---|---|
服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |