赞
踩
1688API接口是阿里巴巴集团推出的一种开放平台,提供了丰富的数据接口、转换工具以及开发资源,为开发者提供了通用的应用接口及大量数据资源,支持开发者在1688上进行商品搜索、订单管理、交易报表及物流等方面的操作。
1688API接口主要包含以下几类:
商品API:提供商品搜索、商品详情、商品发布等接口。
订单API:提供订单查询、订单状态更新、订单创建等接口。
物流API:提供物流信息查询、物流订单查询等接口。
用户API:提供用户信息查询、用户认证等接口。
数据API:提供交易报表、商品统计等接口。
开发者可基于1688API接口打造自己的在线商城、批发平台及电商应用等,实现企业信息化、资源共享、创新发展等目标。
1688API请求参数
公共参数
请求地址:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(请求调用KEY) |
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版本 |
请求参数
请求参数:num_iid=610947572360
参数说明:num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 0 | 宝贝详情数据 |
请求示例
Curl PHP PHPsdk JAVA C# Python Golang javascript JS-SDK Ruby Swift Objective-C C C++ Node.JS Kotlin Rust R MATLAB
PHP
- <?php
-
- // 请求示例 url 默认请求参数已经URL编码处理
- // 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
- $method = "GET";
- $url = "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
- $curl = curl_init();
- curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
- curl_setopt($curl, CURLOPT_URL, $url);
- curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
- curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
- curl_setopt($curl, CURLOPT_FAILONERROR, false);
- curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
- curl_setopt($curl, CURLOPT_HEADER, true);
- curl_setopt($curl, CURLOPT_ENCODING, "gzip");
- var_dump(curl_exec($curl));
- ?>
PHPsdk
- <?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_get",
- "api_params"=>array (
- 'num_iid' => '610947572360',
- )
- )
- );
- var_dump($api_data);
- ?>
JAVA
- import java.io.BufferedReader;
- import java.io.IOException;
- import java.io.InputStream;
- import java.io.InputStreamReader;
- import java.io.Reader;
- import java.net.URL;
- import java.nio.charset.Charset;
- import org.json.JSONException;
- import org.json.JSONObject;
- import java.io.PrintWriter;
- import java.net.URLConnection;
-
- public class Example {
- private static String readAll(Reader rd) throws IOException {
- StringBuilder sb = new StringBuilder();
- int cp;
- while ((cp = rd.read()) != -1) {
- sb.append((char) cp);
- }
- return sb.toString();
- }
- public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
- URL realUrl = new URL(url);
- URLConnection conn = realUrl.openConnection();
- conn.setDoOutput(true);
- conn.setDoInput(true);
- PrintWriter out = new PrintWriter(conn.getOutputStream());
- out.print(body);
- out.flush();
- InputStream instream = conn.getInputStream();
- try {
- BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
- String jsonText = readAll(rd);
- JSONObject json = new JSONObject(jsonText);
- return json;
- } finally {
- instream.close();
- }
- }
- public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
- URL realUrl = new URL(url);
- URLConnection conn = realUrl.openConnection();
- InputStream instream = conn.getInputStream();
- try {
- BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
- String jsonText = readAll(rd);
- JSONObject json = new JSONObject(jsonText);
- return json;
- } finally {
- instream.close();
- }
- }
- public static void main(String[] args) throws IOException, JSONException {
- // 请求示例 url 默认请求参数已经URL编码处理
- String url = "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
- JSONObject json = getRequestFromUrl(url);
- System.out.println(json.toString());
- }
-
- }
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。