一、应用程序编程接口
API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件的以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。
API全称 "Application Programming Interface"，中文名称“应用程序编程的接口”，API相当于一个网络平台的身份地址， 目的是为了供给应用程序与开发人员根据某软件或硬件才得以拜访一组例程的能力，而又无需拜访源代码和了解内部作业机制的细节，产品需求拥有API才可以对电脑授权，然后才可能激活你的产品。
API的历史与现状当WINDOWS操作系统开始占据主导地位的时候，开发WINDOWS平台下的应用程序成为人们的需要。而在WINDOWS程序设计领域处于发展的初期，WINDOWS程序员所能使用的编程工具唯有API函数，这些函数是WINDOWS提供给应用程序与操作系统的接口，他们犹如“积木块”一样，可以搭建出各种界面丰富，功能灵活的应用程序。所以可以认为API函数是构筑整个WINDOWS框架的基石，在它的下面是WINDOWS的操作系统核心，而它的上面则是所有的华丽的WINDOWS应用程序。但是，没有合适的Windows编程平台，程序员想编写具有Windows风格的软件，必须借助API，API也因此被赋予至高无上的地位。那时的WINDOWS程序开发还是比较复杂的工作，程序员必须熟记一大堆常用的API函数，而且还得对WINDOWS操作系统有深入的了解。然而随着软件技术的不断发展，在WINDOWS平台上出现了很多优秀的可视化编程环境，程序员可以采用“即见即所得”的编程方式来开发具有精美用户界面和功能强大的应用程序。
这些优秀可视化编程环境操作简单、界面友好（诸如VB、VC++、DELPHI等），在这些工具中提供了大量的类库和各种控件，它们替代了API的神秘功能，事实上这些类库和控件都是构架在WIN32 API函数基础之上的，是封装了的API函数的集合。它们把常用的API函数的组合在一起成为一个控件或类库，并赋予其方便的使用方法，所以极大的加速了WINDOWS应用程序开发的过程。有了这些控件和类库，程序员便可以把主要精力放在程序整体功能的设计上，而不必过于关注技术细节。实际上如果我们要开发出更灵活、更实用、更具效率的应用程序，必然要涉及到直接使用API函数，虽然类库和控件使应用程序的开发简单的多，但它们只提供WINDOWS的一般功能，对于比较复杂和特殊的功能来说，使用类库和控件是非常难以实现的，这时就需要采用API函数来实现。
API 分为四种类型： 远程过程调用（RPC）：通过作用在共享数据缓存器上的过程（或任务）实现程序间的通信。 标准查询语言（SQL）：是标准的访问数据的查询语言，通过通用数据库实现应用程序间的数据共享。 文件传输：文件传输通过发送格式化文件实现应用程序间数据共享。 信息交付：指松耦合或紧耦合应用程序间的小型格式化信息，通过程序间的直接通信实现数据共享。 当前应用于 API 的标准包括 ANSI 标准 SQL API。另外还有一些应用于其它类型的标准尚在制定之中。API 可以应用于所有计算机平台和操作系统。这些 API 以不同的格式连接数据（如共享数据缓存器、数据库结构、文件框架）。每种数据格式要求以不同的数据命令和参数实现正确的数据通信，但同时也会产生不同类型的错误。因此，除了具备执行数据共享任务所需的知识以外，这些类型的 API 还必须解决很多网络参数问题和可能的差错条件，即每个应用程序都必须清楚自身是否有强大的性能支持程序间通信。相反由于这种 API 只处理一种信息格式，所以该情形下的信息交付 API 只提供较小的命令、网络参数以及差错条件子集。正因为如此，交付 API 方式大大降低了系统复杂性，所以当应用程序需要通过多个平台实现数据共享时，采用信息交付 API 类型是比较理想的选择。 API 与图形用户接口（GUI）或命令接口有着鲜明的差别：API 接口属于一种操作系统或程序接口，而后两者都属于直接用户接口。 有时公司会将 API 作为其公共开放系统。也就是说，公司制定自己的系统接口标准，当需要执行系统整合、自定义和程序应用等操作时，公司所有成员都可以通过该接口标准调用源代码，该接口标准被称之为开放式 API。
二、API应用体现
请求地址: 接口测试界面
请求参数
请求参数：q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
title | String | 0 | 法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装 | 商品标题 |
pic_url | String | 0 | //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg | 宝贝图片 |
promotion_price | Float | 0 | 178.00 | 优惠价 |
price | Float | 0 | 178.00 | 价格 |
sales | Int | 0 | 890 | 销量 |
num_iid | Bigint | 0 | 577437133060 | 宝贝ID |
sample_id | String | 0 | 商品风格标识ID | |
seller_nick | String | 0 | 初穆旗舰店 | 掌柜昵称 |
post_fee | Float | 0 | 10.00 | 物流费用 |
area | String | 0 | 山东 | 店铺所在地 |
detail_url | String | 0 | //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 | 宝贝链接 |
seller_info | Mix | 0 | {"level": 99, "shop_type": "B", "user_num_id": "2217148345", "cid": 0, "delivery_score": "", "item_score": "", "score_p": ""} | 卖家信息 |
请求示例
Curl
PHP
PHPsdk
JAVA
C#
Python
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
{
"items": {
"page": "1",
"real_total_results": 2000,
"total_results": 2000,
"page_size": 13,
"pagecount": "100",
"data_from": "ti",
"item": [
{
"title": "【限时秒杀】秋水伊人优雅V领针织衫女2022气质蓝色开衫外套上衣",
"pic_url": "https://gw.alicdn.com/i3/528296282/O1CN010bop1g1wHCtcQ4zKj_!!0-item_pic.jpg",
"promotion_price": "409.0",
"price": "409.0",
"sales": 28,
"num_iid": "684180529170",
"seller_nick": "秋水伊人官方旗舰店",
"seller_id": "528296282",
"detail_url": "https://item.taobao.com/item.htm?id=684180529170"
},
{
"title": "拉夏贝尔纯棉短袖t恤女夏2023新款夏季女装宽松上衣春款半袖体恤X",
"pic_url": "https://gw.alicdn.com/i1/2207860246915/O1CN01xwvI0H20x7YaH2pzV_!!0-item_pic.jpg",
"promotion_price": "59.0",
"price": "59.0",
"sales": 879,
"num_iid": "676549801401",
"seller_nick": "lachapellesport旗舰店",
"seller_id": "2207860246915",
"detail_url": "https://item.taobao.com/item.htm?id=676549801401"
},
{
"title": "真维斯纯棉短袖t恤女夏圆领2023新款宽松大码小众设计感情侣上衣M",
"pic_url": "https://gw.alicdn.com/i1/2214213105378/O1CN0184a1rl1pbAqpSUgzF_!!0-item_pic.jpg",
"promotion_price": "80.0",
"price": "80.0",
"sales": 1959,
"num_iid": "696779926256",
"seller_nick": "JEANSWESTLIFE旗舰店",
"seller_id": "2214213105378",
"detail_url": "https://item.taobao.com/item.htm?id=696779926256"
},
{
"title": "高腰微喇裤女春秋冬显瘦加绒裤子女冬季黑色西装裤女开叉喇叭裤子",
"pic_url": "https://g.search1.alicdn.com/img/i1/59475456/O1CN015bm11s1qAtiliVw0B_!!0-saturn_solar.jpg",
"promotion_price": "129.0",
"price": "129.0",
"sales": 0,
"num_iid": "684911509697",
"seller_nick": null,
"seller_id": "2122196484",
"detail_url": "https://item.taobao.com/item.htm?id=684911509697"
},
{
"title": "白色缎面蝴蝶结衬衫女长袖2022新款秋冬季百搭时尚洋气设计感衬衣",
"pic_url": "https://gw.alicdn.com/i4/3937219703/O1CN01uaDQbA2LY1oiSW2Th_!!3937219703-0-C2M.jpg",
"promotion_price": "74.85",
"price": "74.85",
"sales": 945,
"num_iid": "690705980308",
"seller_nick": "天天特卖工厂店",
"seller_id": "3937219703",
"detail_url": "https://item.taobao.com/item.htm?id=690705980308"
},
{
"title": "双面德绒方领打底衫秋冬2022新款内搭修身长袖T恤女加绒保暖上衣",
"pic_url": "https://gw.alicdn.com/i3/3937219703/O1CN01biFDZa2LY1p3PJgGJ_!!3937219703-0-C2M.jpg",
"promotion_price": "29.85",
"price": "29.85",
"sales": 1322,
"num_iid": "693992095642",
"seller_nick": "天天特卖工厂店",
"seller_id": "3937219703",
"detail_url": "https://item.taobao.com/item.htm?id=693992095642"
},
{
"title": "红袖卫衣oversize小众高街潮牌ins春秋新款女装条纹显瘦刺绣上衣",
"pic_url": "https://gw.alicdn.com/i2/708558593/O1CN01Xvt1h82DLeCjNvSYx_!!708558593.jpg",
"promotion_price": "479.0",
"price": "479.0",
"sales": 73,
"num_iid": "677984509473",
"seller_nick": "红袖官方旗舰店",
"seller_id": "708558593",
"detail_url": "https://item.taobao.com/item.htm?id=677984509473"
},
{
"title": "秋装总裁范翻领西装套装女2022新款帅气小西服休闲裤丝绒两件套",
"pic_url": "https://g.search.alicdn.com/img/i4/43183098/O1CN01I3LWVK1YkvnDRAK6t_!!0-saturn_solar.jpg",
"promotion_price": "830.0",
"price": "830.0",
"sales": 0,
"num_iid": "683113316227",
"seller_nick": null,
"seller_id": "1677086955",
"detail_url": "https://item.taobao.com/item.htm?id=683113316227"
},
{
"title": "JWP真维斯女装休闲牛仔裤春秋季潮流高腰紧身学生女式牛仔长裤女",
"pic_url": "https://gw.alicdn.com/i1/289268212/O1CN01z0Izxl2AX9Il7dgTb_!!0-item_pic.jpg",
"promotion_price": "179.0",
"price": "179.0",
"sales": 80,
"num_iid": "679537546936",
"seller_nick": "真维斯官方旗舰店",
"seller_id": "289268212",
"detail_url": "https://item.taobao.com/item.htm?id=679537546936"
},
{
"title": "逸阳纯棉短袖t恤女夏白色正肩宽松显瘦半袖修身休闲短款夏季上衣",
"pic_url": "https://gw.alicdn.com/i1/408107205/O1CN01WUmQhn235wPutkjsW_!!0-item_pic.jpg",
"promotion_price": "68.0",
"price": "68.0",
"sales": 528,
"num_iid": "612997991418",
"seller_nick": "逸阳旗舰店",
"seller_id": "408107205",
"detail_url": "https://item.taobao.com/item.htm?id=612997991418"
},
{
"title": "红袖黑白条纹T恤春季2023新款女装字母印花圆领套头休闲百搭上衣",
"pic_url": "https://gw.alicdn.com/i1/708558593/O1CN01Xpnj8o2DLeCj0JBml_!!708558593.jpg",
"promotion_price": "239.0",
"price": "239.0",
"sales": 26,
"num_iid": "696406179655",
"seller_nick": "红袖官方旗舰店",
"seller_id": "708558593",
"detail_url": "https://item.taobao.com/item.htm?id=696406179655"
},
{
"title": "新款两面棉衣短外套女外套可仿貂毛糯短款复古时尚软穿imone冬季2",
"pic_url": "https://g.search1.alicdn.com/img/i1/131161173/O1CN0165JNbC1KXHMkmKvEw_!!0-saturn_solar.jpg",
"promotion_price": "339.0",
"price": "339.0",
"sales": 0,
"num_iid": "693696043132",
"seller_nick": null,
"seller_id": "3679012311",
"detail_url": "https://item.taobao.com/item.htm?id=693696043132"
},
{
"title": "黑色开叉牛仔裤女春秋2023年新款大码高腰紧身显瘦拖地微喇叭裤子",
"pic_url": "https://gw.alicdn.com/i3/3482531726/O1CN01sRGwg51OcYNlZdBeR_!!0-item_pic.jpg",
"promotion_price": "45.0",
"price": "45.0",
"sales": 1276,
"num_iid": "680614274668",
"seller_nick": "傲俏旗舰店",
"seller_id": "3482531726",
"detail_url": "https://item.taobao.com/item.htm?id=680614274668"
}
],
"item_weight_update": 0
},
"error_code": "0000",
"reason": "ok",
"secache": "a8881ed5637e3c7e84f03acdc86be64f",
"secache_time": 1676352768,
"secache_date": "2023-02-14 13:32:48",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:49 max:10000 all[98=49+11+38];expires:2030-12-31",
"execution_time": "1.507",
"server_time": "Beijing/2023-02-14 13:32:48",
"client_ip": "220.177.180.58",
"call_args": {
"q": "女装",
"start_price": "0",
"end_price": "0",
"page": "1",
"cat": "0"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_api",
"server_memory": "5.97MB",
"request_id": "gw-1.63eb1cff1b8a4",
"last_id": "1548421081"
}
