电子商务.md

书籍ISBN数据查询

https://api.isoyu.com/

通过请求10位或13位的ISBN码可以反馈给用户相应的书籍信息和推荐指数

最低 0.02元/次

请求地址

GET https://api.isoyu.com/book/isbn

请求参数

名称	必填	类型	说明
appCode	是	string	用户授权码，参考API调用
sub	是	string	10位或者13位的ISBN码

返回data参数

名称	类型	说明
levelNum	string	推荐指数
subtitle	string	副标题
author	string	作者
pubdate	string	发版日期
origin_title	string	源标题(国外源标题)
binding	string	装订方式
pages	string	总页数
images_medium	string	缩略图
images_large	string	大图
publisher	string	出版社名称
isbn10	string	10位ISBN码
isbn13	string	13位ISBN码
title	string	书籍名称
summary	string	内容简介
price	string	销售价格

SDK调用

$client = new Client("YourAppCode");



$result = $client->bookIsbn()

    ->withSub('9787544258975')
    ->request();

返回示例：

{
    "code":0,
    "message": "成功的返回",
    "data": {
         "levelNum":"8.0",

         "subtitle":"",

         "author":" 加西亚·马尔克斯",

         "pubdate":"2012-9-1",

         "origin_title":El amor en los tiempos del cólera",

         "binding":"精装",

         "pages":"401",

         "images_medium":"http://open.6api.net/mpic/s11284102.jpg",

         "images_large":"http://open.6api.net/lpic/s11284102.jpg",

         "publisher":"南海出版公司",

         "isbn10":"7544258971",

         "isbn13":"9787544258975",

         "title":"霍乱时期的爱情",

         "summary":"《霍乱时期的爱情》是加西亚•马尔克斯获得诺贝尔文学奖之后完成的第一部小说。讲述了一段跨越半个多世纪的爱情史诗，穷尽了所有爱情的可能性：忠贞的、隐秘的、粗暴的、羞怯的、柏拉图式的、放荡的、转瞬即逝的、生死相依的……再现了时光的无情流逝，被誉为“人类有史以来最伟大的爱情小说”，是20世纪最重要的经典文学巨著之一。",

         "price":"39.50元"
    }
}

常用快递查询

根据快递单号查询快递状态信息，支持国内常规快递公司和物流公司，信息更新及时

接口1：根据单号查询快递信息

最低 0.008元/次

请求地址

GET https://api.isoyu.com/express/query

请求参数

名称	必填	类型	说明
appCode	是	string	用户授权码，参考API调用
com	是	string	快递公司字母简称。可以使用auto代替,此时将自动识别快递单号。【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
nu	是	string	需要查询的快递单号
phone	否	string	手机尾号后四位【寄件人手机号或者收件人手机号】

返回参数

参数名称	类型	示例值	描述
update	Number	1588071235436	更新时间戳
upgrade_info	String		提示信息，用于提醒用户可能出现的情况
updateStr	String	2020-04-28 18:53:55	更新时间
logo	String	http://app2.showapi.com/img/expImg/zto.jpg	快递公司logo
dataSize	Number	11	数据节点的长度
status	Number	4	快递状态 1 暂无记录 2 在途中 3 派送中 4 已签收 (完结状态) 5 用户拒签 6 疑难件 7 无效单 (完结状态) 8 超时单 9 签收失败 10 退回
fee_num	Number	1	计费次数。例如：0为计费0次，即不计费；1为计费1次
tel	String	95311	快递公司联系方式
data	Object[]
-	time	String	2019-11-16 21:33:56
-	context	String	快件已在 【九江城西港】 签收, 签收人: 速递易, 如有疑问请电联:（15779254414）, 投诉电话:（13687028760）, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】
expSpellName	String	zhongtong	快递编码
msg	String	查询成功	返回提示信息
mailNo	String	75312165465979	快递单号
queryTimes	Number	1	无走件记录时被查询次数 注意：在24小时内，查询次数>10次将会计费

| flag | Boolean | true | true：查询成功，表示ret_code=0且data的长度>0。可使用本字段做是否读取data列表的依据。 false：查询失败。 | | expTextName | String | 中通快递 | 快递简称 | | possibleExpList | String[] | [] | 自动识别结果 |

SDK调用

$client = new Client("YourAppCode");



$result = $client->expressQuery()

    ->withCom('快递公司简称')
    ->withNu('运单号')
    ->request();

接口2：快递公司列表（免费）

请求地址

GET https://api.isoyu.com/express/exp_list

请求参数

名称	必填	类型	说明
expName	否	string	快递公司关键词
maxSize	否	string	分页时,返回的最大数据量
page	否	string	当前页数

返回参数

名称	类型	描述
expressList	String	快递公司列表数据
- expName	String	快递公司名称
- simpleName	String	简称
- url	String	官方网址
- note	String	描述
- phone	String	快递公司服务电话
- imgUrl	String	快递公司图标

JSON返回示例：

SDK调用

$client = new Client("YourAppCode");



$result = $client->expressExpList()

    ->withExpName('如风')
    ->withMaxSize(20)
    ->request();

返回示例：

    {

    "code":0,

    "message":"操作成功",

    "data":{

        "page": 1,

        "expressList": [

            {

            "imgUrl": "http://app2.showapi.com/img/expImg/rufeng.jpg",

            "simpleName": "rufeng",

            "phone": "400-010-6660",

            "expName": "如风达快递",

            "note": "",

            "url": "http://www.rufengda.com"

            },

            {

            "imgUrl": "http://app2.showapi.com/img/expImg/562.gif",

            "simpleName": "rufengda",

            "phone": "400-010-6660",

            "expName": "凡客如风达",

            "note": "",

            "url": "http://www.rufengda.com"

            }

        ],

        "allNum": 2,

        "msg": "查询成功!",

        "maxSize": 20

        }

    }

二维码解码

请传递图片base64编码数据或图片地址（任选其一），自动识别常见的二维码类型。请注意：该接口请使用POST方式请求，base64数据大小不超过300k。在保证图片清晰度的情况下，图片越小识别速度越快，结果也越稳定。

最低 0.02元/次

请求地址

GET https://api.isoyu.com/qrcode/codec

请求参数

名称	类型	必填	说明
appCode	string	是	用户授权码，参考API调用
qrpic	string	否	二维码图片的base64编码
qrurl	string	否	二维码图片地址

返回data参数

名称	类型	示例值	说明
qrtype	string	WeChat	二维码类型
qrcodec	string	http://weixin.qq.com/r/nEx-ZyfEaXoWrWME9xmO	二维码内容

SDK调用

$client = new Client("YourAppCode");



$result = $client->qrcodeCodec()


    ->request();

返回示例：

{
    "code":0,
    "message": "成功",
    "data": [
        {

          "qrtype": "Url",

          "qrcodec": "https://api.isoyu.com"

        }
    ]
}

二维码生成

[danger]### 免费接口，每日100次免费调用，会员可不限次数调用，购买API会员

按照设定的参数、生成二维码

每日100次免费调用

请求地址

GET https://api.isoyu.com/qrcode/index

请求参数

名称	必填	类型	说明
appCode	是	string	用户授权码，参考API调用
text	否	string	二维码内容
el	否	string	纠错等级，el可用值：h\q\m\l，例如：h
bgcolor	否	string	背景色代码，例如：ffffff
fgcolor	否	string	前景色代码，例如：000000
logo	否	string	logo图片URL地址或base64encode编码的图片内容，需要urlencode
w	否	int	尺寸大小（像素），例如：300
m	否	int	边距大小（像素），例如：10
lw	否	int	logo宽度（像素），例如：60
type	否	int	返回模式，1:二维码图片以base64encode编码返回 2:直接返回二维码图像，默认1

返回data参数

名称	类型	说明
见JSON返回示例	-

SDK调用

$client = new Client("YourAppCode");



$result = $client->qrcodeIndex()

    ->withText('二维码内容')
    ->withBgcolor('ffffff')
    ->withFgcolor('000000')
    ->withLogo()
    ->withW()
    ->withM()
    ->withType()
    ->request();

返回示例：

{ 
    "message": "success", 
    "data": {
         "base64_image": "base64encode编码的二维码图片内容" 
    },
     "code": 0
 }

汇率换算

[danger]### 免费接口，每日100次免费调用，会员可不限次数调用，购买API会员

外汇报价，货币汇率，包含三个接口：常用汇率查询、货币列表和实时汇率查询换算

每日100次免费调用

接口1：常用汇率查询

汇率查询，数据仅供参考，交易时以银行柜台成交价为准

请求地址

GET https://api.isoyu.com/exchange/query

请求参数（无）

SDK调用

$client = new Client("YourAppCode");

// 常用汇率查询
$result = $client->exchangeQuery()

    ->request();

返回示例：

{
    "message": "查询成功",
    "data": {
        "update": "2016-07-22 10:32:31",
        "list": [
            [
                "美元", /*货币名称*/
                "100", /*交易单位*/
                "665.63", /*现汇买入价*/
                "660.3", /*现钞买入价*/
                "668.3", /*现钞卖出价*/
                "666.69" /*中行折算价*/
            ],
            [
                "港币",
                "100",
                "85.83",
                "85.14",
                "86.15",
                "85.96"
            ],
            [
                "日元",
                "100",
                "6.2771",
                "6.0834",
                "6.3211",
                "6.3014"
            ],
            [
                "欧元",
                "100",
                "732.74",
                "710.13",
                "737.88",
                "735.79"
            ],
            [
                "英镑",
                "100",
                "879.28",
                "852.15",
                "885.46",
                "879.01"
            ]
        ]
    },
    "code": 0
}

接口2：货币列表

支持的货币列表

请求地址

https://api.isoyu.com/exchange/currency

请求参数（无）

SDK调用

$client = new Client("YourAppCode");

// 获取货币列表
$result = $client->exchangeCurrency()
    ->request();

返回示例：

{
    "message": "查询成功",
    "data": {
        "list": [
            {
                "name": "人民币", /*货币名称*/
                "code": "CNY" /*货币代码*/
            },
            {
                "name": "美元",
                "code": "USD"
            },
            {
                "name": "日元",
                "code": "JPY"
            },
            {
                "name": "欧元",
                "code": "EUR"
            },
            {
                "name": "英镑",
                "code": "GBP"
            },
        ...
        ]
    },
    "code": 0
}

接口3：实时汇率查询

实时货币汇率查询换算，数据仅供参考，交易时以银行柜台成交价为准

请求地址

https://api.isoyu.com/exchange/convert

请求参数

名称	必填	类型	说明
appCode	是	string	用户授权码，参考API调用
from	是	string	转换汇率前的货币代码
to	是	string	转换汇率成的货币代码

SDK调用

$client = new Client("YourAppCode");

// 查询实时汇率
$result = $client->exchangeConvert()
    ->withFrom()
    ->withTo()
    ->request();

返回示例：

{
    "message": "查询成功",
    "data": [
        {
            "currencyF": "JPY", /*货币代码*/
            "currencyF_Name": "日元", /*货币名称*/
            "currencyT": "BHD", /*货币代码*/
            "currencyT_Name": "巴林第纳尔", /*货币名称*/
            "currencyFD": 1,
            "exchange": "0.0032685972", /*当前汇率*/
            "result": "0.0032",/*当前汇率*/
            "updateTime": "2014-11-07 13:58:02"
        },
        {
            "currencyF": "BHD",
            "currencyF_Name": "巴林第纳尔",
            "currencyT": "JPY",
            "currencyT_Name": "日元",
            "currencyFD": 1,
            "exchange": "305.9416445623",
            "result": 305.9416,
            "updateTime": "2014-11-07 13:58:01"
        }
    ],
    "code": 0
}

收货地址解析

[danger]### 会员接口，仅限会员使用，购买API会员

此接口可以解析出文本中的收货人姓名、联系方式、邮编和详细地址。并且可以将地址拆分出省市区（自治区、旗、盟等），方便电商和物流等项目应用。text参数中的内容同一类型（例如电话号码和邮编都是数字，连在一起的话，最好有空格或逗号相隔）。

请求地址

GET https://api.isoyu.com/express/address

请求参数

名称	必填	类型	说明
appCode	是	string	用户授权码，参考API调用
text	是	string	文本内容

返回data参数

名称	类型	示例值	说明
mobile	string	13800138000	移动电话号码
name	string	马云	收货人姓名
province	string	浙江省	省/特区/自治区/直辖市
city	string	杭州市	城市
district	string	滨江区	区县
postcode	string	310052	邮编
detail	string	浙江省杭州市滨江区网商路699号	完整收货地址

SDK调用

$client = new Client("YourAppCode");



$result = $client->expressAddress()

    ->withText('马云,13800138000浙江省杭州市滨江区网商路699号310052')
    ->request();

返回示例：

{
    "code":0,
    "message": "成功的返回",
    "data": {
        "mobile":"13800138000",

        "name":"马云",

        "province":"浙江省",

        "city":"杭州市",

        "district":"滨江区",

        "postcode":"310052",

        "detail":"浙江省杭州市滨江区网商路699号"
    }
}

淘宝客订单号检测

可以检测淘宝订单号是否使用淘客下单，避免商家损失佣金

最低 0.016元/次

请求地址

GET https://api.isoyu.com/taobaoke/check_order

请求参数

名称	类型	必填	说明
appCode	string	是	用户授权码，参考API调用
orderNo	string	是	订单号

返回data参数

名称	类型	说明
taoke	bool	true：淘客订单 false：非淘客订单或订单失效
remark	string	说明

SDK调用

$client = new Client("YourAppCode");



$result = $client->taobaokeCheckOrder()

    ->withOrderNo('淘宝订单号')
    ->request();

返回示例：

{
    "code":0,
    "message": "成功",
    "data": [
        {

	  	"taoke": true,

		"remark": "请注意，该订单为淘客订单",

		"hasNextPage": "1",

		"orders": []
        }
    ]
}

淘口令解析

将淘口令解析还原成url，商品口令、券口令可完美解析出商品id

最低 0.0025元/次

请求地址

GET https://api.isoyu.com/taobaoke/query

请求参数

名称	类型	必填	说明
appCode	string	是	用户授权码，参考API调用
tkl	string	是	淘口令

返回data参数

名称	类型	说明
num_iid	string	商品id, 只要口令是商品口令或券口令时才返回商品id
content	string	淘口令-文案
title	string	商品标题
price	string	商品价格(手淘分享的口令，才可以解析出价格)
pic_url	string	口令图片
url	string	跳转url(长链)
native_url	string	移动端调起地址
thumb_pic_url	string	缩略图

SDK调用

$client = new Client("YourAppCode");



$result = $client->taobaokeQuery()

    ->withTkl('￥4SKAZC8brVD￥')
    ->request();

返回示例：

{
    "code":0,
    "message": "成功",
    "data": [
        {

        "content": "FANBIYA X8隐形蓝牙耳机无线迷你超小挂耳式运动开车入耳塞微型头戴式可接听电话手机男女通用适用苹果",

        "native_url": "tbopen://m.taobao.com/tbopen/index.html?a.....",

        "pic_url": "https://img.alicdn.com/tfscom/i2/2289894494/O1CN01IFLHLJ1j4IOYvfX3g_!!0-item_pic.jpg",

        "suc": true,

        "thumb_pic_url": "https://img.alicdn.com/tfscom/i2/2289894494/O1CN01IFLHLJ1j4IOYvfX3g_!!0-item_pic.jpg_170x170.jpg",

        "title": "淘口令-页面",

        "url": "https://uland.taobao.com/coupon/edetail?e=jTS9Uk507ZQG.......",

        "request_id": "88gbusl7o1at",

        "num_iid": "572096814881"
        }
    ]
}

条码查询

通过条码(条形码)查询商品信息（名称、价格、图片、厂家、描述等字段），融合了包括中国条码中心在内的多个数据源。

最低 0.005元/次

请求地址

GET https://api.isoyu.com/barcode/query

请求参数

参数名称	类型	必须	描述
appCode	string	是	用户授权码，参考API调用
code	String	是	条形码

返回data参数

名称	类型	示例值	描述
flag	String	true	操作是否成功
code	String	6938166920785	条形码
goodsName	String	苹果醋	商品名称
manuName	String	新乡市和丝露饮品有限公司	厂商
spec	String	268ml	规格
price	String	3.00	参考价格(单位:元)
trademark	String	醋美人生	商标/品牌名称
img	String	http://www.aijiazixuan.com/upfilesmall/2013-12/2013121962731065.jpg	图片地址
ret_code	String	0	返回代码 0为成功,其他为失败
goodsType	String	食品、饮料和烟草>>饮料	商品分类
sptmImg	String	http://app2.showapi.com/img/barCode\_img/20161116/14792662xxxxxxx.png	条码图片
ycg	String	中国	原产地(可能无此参数信息)
note	String		备注信息
remark	String	查询成功！	返回结果的描述
manuAddress	String		厂商地址
imgList	String		条码中心图片列表

SDK调用

$client = new Client("YourAppCode");



$result = $client->barcodeQuery()

    ->withCode('6938166920785')

    ->request();

dump($result);

返回数据示例：

{
    "message": "查询成功",
    "data": {
        "sptmImg": "",
        "spec": "268ml",
        "remark": "查询成功！",
        "img": "http://app2.showapi.com/img/barCode_img/2f7e639b-aa2f-4248-ae79-f0acc6ea56e6.jpg",
        "code": "6938166920785",
        "ycg": "",
        "manuName": "新乡市和丝露饮品有限公司",
        "ret_code": "0",
        "imgList": [],
        "flag": true,
        "price": "3.00",
        "trademark": "醋美人生",
        "manuAddress": "河南省新乡市原阳县新城开发区",
        "note": "备注：经查，该厂商识别代码已在中国物品编码中心注册，但编码信息未按规定通报",
        "goodsName": "苹果醋",
        "goodsType": "工业生产和制造业>>食品和饮料工业>>饮料加工>>水饮料加工"
    },
    "code": 0
}

[danger] 返回code为0时计费。

图书电商数据

[danger]### 免费接口，每日100次免费调用，会员可不限次数调用，购买API会员

于万千之中选择你所爱--好书推荐，值得你信赖。

每日100次免费调用

接口1：图书分类目录

请求地址

GET https://api.isoyu.com/book/catalog

请求参数

无

返回data参数

名称	类型	说明
id	int	目录编号
catalog	string	目录内容

SDK调用

$client = new Client("YourAppCode");



$result = $client->bookCatalog()

    ->request();

返回示例：

{
    "code":0,
    "message": "成功的返回",
    "data": {
        { "id":"242", "catalog":"中国文学" }, 
        { "id":"243", "catalog":"外国文学" }, 
        { "id":"244", "catalog":"儿童文学" },
        { "id":"245", "catalog":"散文" }, 
        { "id":"246", "catalog":"经典名著" }, 
        { "id":"247", "catalog":"小说" }, 
        { "id":"248", "catalog":"历史" }, 
        { "id":"249", "catalog":"教育" }, 
        { "id":"250", "catalog":"成功励志" }, 
        { "id":"251", "catalog":"心灵鸡汤" }, 
        { "id":"252", "catalog":"人物传记" },
        { "id":"253", "catalog":"心理学" }, 
        { "id":"254", "catalog":"管理" }, 
        { "id":"255", "catalog":"经济" }, 
        { "id":"256", "catalog":"理财" },
        { "id":"257", "catalog":"哲学" },
        { "id":"258", "catalog":"计算机" }
    }

接口2：图书内容

请求地址

GET https://api.isoyu.com/book/query

请求参数

名称	必填	类型	说明
catalog_id	是	int	目录编号
pn	是	int	数据返回起始
rn	是	int	数据返回条数，最大30

返回参数

名称	类型	说明
见JSON返回示例	-

SDK调用

$client = new Client("YourAppCode");



$result = $client->bookQuery()

    ->withCategoryId(242)
    ->withPn(2)
    ->withRn(1)
    ->request();

返回示例：

{
    "code":0,
    "message": "成功的返回",
    "data": [
 { "title":"明朝那些事儿", "catalog":"中国文学 历史 小说 ", "tags":"中国历史 历史小说 好书推荐 明朝 畅销书排行榜 ", "sub1":"当时明月经典著作：《明朝那些事儿》", "sub2":"《明朝那些事儿》是中国青年历史学者当时明月创作的一系列连载的历史小说，作品讲述了从1344年到1644年间中国明朝三百年的历史故事。小说以史料为基础，以年代和具体人物为主线，以小说的笔法，从朱元璋出生开始讲起，到崇祯皇帝自缢、明朝灭亡结束，将明朝十七帝、王公权贵和小人物的命运等娓娓道来，进行了全景式的展示与描写。而作品对官场政治、战争、帝王心术等的描写更为突出，着墨更多，也对当时的政治经济制度和人伦道德进行了演绎。《明朝那些事儿》精彩绝伦，引人入胜，掀起了一股明朝热。\\n《明朝那些事儿》的作者当年明月，原名石悦，男，于1979年出生在宜昌一个普通的干部家庭里，曾是广东顺德海关的一名公务员，现为中国海关总署缉私警察。他于2006年3月在天涯社区首次发表《明朝那些事儿》，于2009年3月21日连载完毕，现已全部集结成书出版发行，一共7部。当年明月是青年历史学者、畅销书作家，也是明史学会会员，更是心灵历史的开创者。他的代表作《明朝那些事儿》销量已过五百万册，为三十年来最畅销的史学读本。\\n《明朝那些事儿》共有七部，第一部从朱元璋的出身开始写起，到永乐大帝夺位的靖难之役结束为止，叙述了明朝最艰苦卓绝的开国过程和永乐夺位、建文失踪的靖难之役……第七部描写了明朝最后一位皇帝崇祯的故事和北方后金势力的崛起。七部历史小说，精彩的演绎了中国明代三百年的历史故事和重要历史人物，吸引了千千万万的读者。\\n《明朝那些事儿》是迄今为止唯一全本白话正说明朝大历史。作者当时明月以通俗浅显甚至娱乐化的手法重述、重写历史，引发了一场“感染”者高烧不退的“读史热”。而因这一系列作品的持续畅销，当时明月连续五年荣登“中国作家富豪榜”，成为近几年国内文化界的一大奇观，也引起了不少争议。\\n《明朝那些事儿》是一部“好读”的历史，也是一部“老百姓”可以读的历史，能够让大家阅读得畅快淋漓。让我们翻开《明朝那些事儿》，走进中国明朝，去细细体会那些事儿……\\n《明朝那些事儿》", "img":"http:\\/\\/apis.juhe.cn\\/goodbook\\/img\\/485e07a3ae0fc5de931b439881a4b013.jpg", "reading":"5841人阅读", "online":"京东商城:http:\\/\\/book.jd.com\\/11014800.html 当当网:http:\\/\\/product.dangdang.com\\/product.aspx?product\_id=22554517 亚马逊:http:\\/\\/www.amazon.cn\\/%E6%98%8E%E6%9C%9D%E9%82%A3%E4%BA%9B%E4%BA%8B%E5%84%BF-%E5%BD%93%E5%B9%B4%E6%98%8E%E6%9C%88\\/dp\\/B005UIJ4NQ\\/ref=sr\_1\_1 苏宁易购:http:\\/\\/www.suning.com\\/emall\\/prd\_10052\_22001\_-7\_1382710\_.html", "bytime":"2013年6月18日" }],
    }

语言翻译

系统支持自动识别源语言也可以指定来源和翻译对象。单次请求不得超过5K字节，约为1600汉字。

最低 0.006元/次

请求地址

GET https://api.isoyu.com/fanyi/index

请求参数

名称	类型	必填	说明
appCode	string	是	用户授权码，参考API调用
text	string	是	需要翻译的内容
to	string	否	目标语言，默认自动识别

返回data参数

名称	类型	示例值	说明
from	string	en	来源语言
to	string	zh	目标语言
src	string	hello	翻译文本
dst	string	你好	翻译结果

SDK调用

$client = new Client("YourAppCode");



$result = $client->fanyiIndex()

    ->withText('hello')
    ->request();

返回示例：

{
    "code":0,
    "message": "成功",
    "data": [
        {

        "from":"en",

        "to":"zh",

        "src":"hello",

        "dst":"你好"

        }
    ]
}