常规的几个API接口（也包括比价）

最新推荐文章于 2025-04-10 09:48:52 发布

weixin_44591984

最新推荐文章于 2025-04-10 09:48:52 发布

阅读量4.7k

点赞数

分类专栏： api 文章标签： api接口接口返回示例

api 专栏收录该内容

5 篇文章

订阅专栏

Api接口就好比一个媒介工具，比如买东西的时候我们要计算价格，可以用算盘、计算器、手机或者电脑进行计算得出结果。接口与其类似，当你需要用到这个功能时就可以调用。
Api接口可以应用于pc端、app、软件等，除了接口一般会有Api接口文档说明来帮助开发者使用。
下面来分享一下免费的api接口以及文档说明：

1.邮编查询

接口地址：http://v.juhe.cn/postcode/query
返回格式：json/xml
请求方式：http get/post
请求示例：http://v.juhe.cn/postcode/query?postcode=215001&key=申请的KEY
接口备注：通过邮编查询对应的地名

请求参数说明：

名称	类型	必填	说明
postcode	string	是	邮编，如：215001
key	string	是	应用APPKEY(应用详细页查询)
page	int	否	页数，默认1
pagesize	int	否	每页返回，默认:20,最大不超过50
dtype	string	否	返回数据的格式,xml或json，默认json

返回参数说明：

名称	类型	说明
error_code	int	返回码
reason	string	返回说明
error_code	int	返回码

JSON返回示例：

"reason": "successed",
"result": {
    "list": [
        {
            "PostNumber": "215001",
            "Province": "江苏省",
            "City": "苏州市",
            "District": "平江区",
            "Address": "廖家巷新光里"
        },
        {
            "PostNumber": "215001",
            "Province": "江苏省",
            "City": "苏州市",
            "District": "平江区",
            "Address": "龙兴桥顺德里"
        }
    ],
    "totalcount": 352,
    "totalpage": 176,
    "currentpage": 1,
    "pagesize": "2"
},
"error_code": 0}

2.手机号码归属地

接口地址：http://apis.juhe.cn/mobile/get
返回格式：json/xml
请求方式：get
请求示例：http://apis.juhe.cn/mobile/get?phone=13429667914&key=您申请的KEY

请求参数说明：

名称	类型	必填	说明
phone	int	是	需要查询的手机号码或手机号码前7位
key	string	是	应用APPKEY(应用详细页查询)
dtype	string	否	返回数据的格式,xml或json，默认json

返回参数说明：

名称	类型	说明
error_code	int	返回码
reason	string	返回说明
result	string	返回结果集
province	string	省份
city	string	城市，(北京、上海、重庆、天津直辖市可能为空)
areacode	string	区号，(部分记录可能为空)
zip	string	邮编，(部分记录可能为空)
company	string	运营商

JSON返回示例：

“resultcode”:“200”,
“reason”:“Return Successd!”,
“result”:{
“province”:“浙江”,
“city”:“杭州”,
“areacode”:“0571”,
“zip”:“310000”,
“company”:“中国移动”,
“card”}

XML返回示例：

在这里插入图片描述

3.影视影讯检索

接口地址：http://op.juhe.cn/onebox/movie/video
返回格式：json/xml
请求方式：http get/post

请求事例：http://op.juhe.cn/onebox/movie/video?key=APPKEY&q=康熙王朝
接口备注：电影：q=心花路放；电视剧：q=继承者们；动漫：q=柯南

请求参数说明：

名称	类型	必填	说明
key	string	是	应用APPKEY(应用详细页查询)
key	string	否	返回数据的格式,xml或json，默认json
q	string	是	影视搜索名称

返回参数说明：

名称	类型	说明
error_code	int	返回码
reason	string	返回说明
error_code	int	返回码

返回说明：

"reason": "查询成功",
"result": {
    "title": "闪电侠第一季",
    "tag": "科幻 / 动作",
    "act": "格兰特·古斯汀 埃涅·赫德森 汤姆·卡瓦纳夫",
    "year": "2014",
    "rating": null,
    "area": "美国",
    "dir": "大卫·努特尔",
    "desc": "《闪电侠》精彩看点：二次元超级英雄再登电视荧屏，《闪电侠》无缝对接《绿箭侠》闪耀登场。《闪电侠》剧情梗概：《闪电侠》的漫画连载开始于1940年，讲述了一名拥有超级速度的学生的故事。50年代起，这个角色则被重新诠释，成为了巴里·艾伦，一名为警署工作的科学家，使用他的超级速度来对抗超级反派们。",
    "cover": "http://i.gtimg.cn/qqlive/img/jpgcache/files/qqvideo/0/0l01jm9yobh4xo4.jpg",
    "vdo_status": "play",
    "playlinks": {
        "youku": "http://v.youku.com/v_show/id_XODQ1NTAzNDE2.html?tpa=dW5pb25faWQ9MTAyMjEzXzEwMDAwNl8wMV8wMQ",
        "qq": "http://v.qq.com/cover/0/0l01jm9yobh4xo4/g0015dn2fw1.html",
        "leshi": "http://www.letv.com/ptv/vplay/21416940.html",
        "pptv": "http://v.pptv.com/show/2uhW1T2jE1G0Mr4.html",
        "sohu": "http://tv.sohu.com/20141210/n406824703.shtml?txid=4e4df35dda9d8ed32c874b1ad590ef59"
    },
    "video_rec": [
        {
            "detail_url": "http://www.360kan.com/tv/PrVtaX7kRzXsMn.html",
            "cover": "http://p2.qhimg.com/t01f969930fae67d1ec.jpg",
            "title": "神盾局特工 第2季"
        },
        {
            "detail_url": "http://www.360kan.com/tv/Q4RvaqOoRmDuMX.html",
            "cover": "http://p6.qhimg.com/t0160a8a6f5b768034a.jpg",
            "title": "遗失的世界"
        },
        {
            "detail_url": "http://www.360kan.com/tv/Q4Frc3GoRmbuMX.html",
            "cover": "http://p7.qhimg.com/t01513514907831e055.jpg",
            "title": "浩劫余生 第一季"
        },
        {
            "detail_url": "http://www.360kan.com/tv/QrFob33oRGboMX.html",
            "cover": "http://p6.qhimg.com/d/_hao360/video/img200909_18_145544738.jpg",
            "title": "新绿野仙踪之铁皮人"
        },
        {
            "detail_url": "http://www.360kan.com/tv/QrRtbaOpRz4nOH.html",
            "cover": "http://p1.qhimg.com/t01d2996b3305923b91.jpg",
            "title": "陨落星辰第三季"
        }
    ],
    "act_s": [
        {
            "name": "格兰特·古斯汀",
            "url": "http://baike.so.com/doc/2041872.html",
            "image": "http://p3.qhimg.com/dmsmty/120_110_100/t019f2fb2f92c6cb2cf.jpg"
        },
        {
            "name": "埃涅·赫德森",
            "url": "http://baike.so.com/doc/3938849.html",
            "image": "http://p2.qhimg.com/dmsmty/120_110_100/t0169332727e692e9fa.jpg"
        },
        {
            "name": "汤姆·卡瓦纳夫",
            "url": "http://baike.so.com/doc/7521211.html",
            "image": "http://p0.qhimg.com/dmsmty/120_110_100/t01d271d8c090330ae2.jpg"
        }
    ]
},
"error_code": 0

4.商品比价查询

API调用地址：

http://sapi.manmanbuy.com/Search.aspx?AppKey=申请appkey&Key=搜索关键词&Class=分类ID&Brand=品牌ID&Site=商城ID&PriceMin=最低价&PriceMax=最高价&PageNum=页号&PageSize=每页商品数&OrderBy=排序方式&ZiYing=是否自营&ExtraParameter=扩展参数

参数说明：

调用示例在这里插入图片描述

调用示例：

http://sapi.manmanbuy.com/Search.aspx?AppKey=123456&Key=iphone&Class=0&Brand=0&Site=0&PriceMin=0&PriceMax=0&PageNum=1&PageSize=30&OrderBy=score&ZiYing=false&ExtraParameter=0

示例说明：

AppKey是：123456（需要申请的），搜索词是：iphone，并且不对分类，品牌，商城做过滤，并且不设置最低价格，也不设置最高价格，搜索的页号为第1页，每页显示30条记录，排序方式是按照权重排序，搜索结果不排除第三方，同时结果包含淘宝数据。

返回格式说明(json)：

返回类型采用json的方式，方便传输及解析返回的Json结果中有以下字段：
在这里插入图片描述
SearchResultList的json说明，该json包含了返回的所有商品信息，每个商品信息的字段如下：

返回结果示例：

(以iphone为例，显示前2条商品信息)

{“State”:1000,“SearchItemsCount”:101520,“SearchCount”:5109,“ClassList”:“57|1074|手机,893|29964|iPhone 配件,892|19512|手机保护套,910|11169|苹果配件, 890|8766|手机贴膜 ,894|6201|其它配件,900|3189|移动电源,889|2067|手机充电器,898|1923|电池/充电器,101|1518|耳机,888|1290|手机电池, 100|1074|蓝牙耳机”,“BrandList”:“155|47184|苹果,0|40476|,634|2166|洛克,6|1134|三星,622|1023|倍思,261|564|品胜,652|558|SGP, 639|537|ESR,623|474|邦克仕,10|423|飞利浦,604|330|摩米士,664|291|优胜仕”,“SiteList”:“1|66732|京东商城,4|8478|亚马逊,3|7917| 当当,13|4821|1号店,6|4605|苏宁易购,8|4149|国美在线,11|3882|易迅网,9|360|新蛋网,161|168|飞牛网,185|147|顺电网,124|123|高鸿商城, 123|69|华强北”,“SearchResultList”:[{“spname”:“苹果(Apple)iPhone 6 (A1586) 16GB 金色移动联通电信4G手机”, “sppic”:“http://img14.360buyimg.com/n7/jfs/t277/193/1005339798/768456/29136988/542d0798N19d42ce3.jpg”, “spurl”:“http://item.jd.com/1217499.html",“spprice”:“5188.00”,“className”:“手机”,“brandName”:“苹果”,“siteName”:"京东商城”, “commentUrl”:“http://item.jd.com/1217499.html#comments-list",“commentCount”:"8773”, “TitleHighLighter”:“苹果(Apple)iPhone 6 (A1586) 16GB 金色移动联通电信4G手机”,“ziying”:“1”,“siteid”:“1”,“id”:“98084930”}, {“spname”:“苹果(Apple)iPhone 6 Plus (A1524) 16GB 金色移动联通电信4G手机”, “sppic”:“http://img14.360buyimg.com/n7/jfs/t346/302/1010969394/231745/50f20b36/542d0e26N894372e9.jpg”, “spurl”:“http://item.jd.com/1217524.html",“spprice”:“5988.00”,“className”:“手机”,“brandName”:“苹果”,“siteName”:"京东商城”, “commentUrl”:“http://item.jd.com/1217524.html#comments-list",“commentCount”:"10288”, “TitleHighLighter”:“苹果(Apple)iPhone 6 Plus (A1524) 16GB 金色移动联通电信4G手机”,“ziying”:“1”,“siteid”:“1”,“id”:“98084932”}]}