API搜索词推荐接口参数说明

       API是指应用程序编程接口，我们通过API接口可以实现特定的功能，而不需要了解其内部实现细节。可以把API接口理解为是特定服务的一种封装，将服务封装起来提供给他人调用，这样一来很多功能不需要从新开发。

       API可以将多个平台的数据和功能相互集成。 例如，您可以将您的电商网站/平台与物流运输服务供应商的账户集成，并导入订单和运输数据。 这样，你就只需在一个平台上进行快递运输操作。

       API可以快速获取电商平台商品信息，如淘宝、天猫、1688、京东、亚马逊等平台商品，再通过API接口，可实现一键铺货，节省大量上传商品的时间，把时间花在更有价值的事情上。 电商订单仓储管理API可以通过集成API进行诸如订单履行、快递管理、标签管理、发票管理、订单打印、货运信息、物流跟踪和签收通知等等的功能来帮助企业实现订单管理、发货管理和运输管理的自动化，简化其物流仓储运营，从而实现成本降低。

 1、公共参数

请求地址:https://api-gw.onebound.cn/1688/item_search_suggest

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

2、请求参数

请求参数：q=女装

参数说明：q:搜索关键字

3、响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		按关键字搜索商品
result	result[]	0	_女装% 夏季	详情数据

4、请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");

$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时，是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;

$api_data = $obapi->exec(
                array(
	                "api_type" =>"1688",
	                "api_name" =>"item_search_suggest",
	                "api_params"=>array (
  'q' => '女装',
)
                )
            );
 var_dump($api_data);
?>

5、响应示例

{
	"items": {
		"result": [
			[
				"_女装% 2021新款春季"
			],
			[
				"_女装% 春秋"
			],
			[
				"_女装% 2021夏季新款"
			],
			[
				"_女装%外套"
			],
			[
				"_女装% 欧美"
			],
			[
				"_女装% 中老年"
			],
			[
				"_女装% 潮流"
			],
			[
				"_女装% 跨境"
			],
			[
				"_女装% 2021新款"
			],
			[
				"_女装% 时尚"
			]
		]
	},
	"secache": "11d2656d59b74f2c8ea26f48e8a00827",
	"secache_time": 1614929727,
	"secache_date": "2021-03-05 15:35:27",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:30 max:10000",
	"execution_time": 0.15,
	"server_time": "Beijing/2021-03-05 15:35:27",
	"client_ip": "106.6.39.197",
	"call_args": {
		"q": "女装"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "3.53MB",
	"request_id": "4.6041df3f32028"
}