电商API调用心得-附可测试电商API接口

前段时间，公司接了一个品牌的数据分析软件，需要我们开发一款可搜集全网电商的该品牌商品订单的软件，并按要求格式导出Excel表格。可筛选条件有时间、销售区域、商品详情、商品sku信息、买家信息等。

我负责电商API接口部分，经过开发和大量测试，已顺利完成软件和各大电商API平台的对接。现分享一些调用心得体会，供大家参考。

• 电商平台的卖家订单信息的抓取一般都需要店铺授权的，所以在测试期间就得先沟通好授权的事情。

• 获取到商品订单详情需要用到两个API：seller_order_list-获取卖出的商品订单列表、seller_order_detail-获取卖出的商品订单详情

• 先通过订单列表接口获取商品订单号，再传入订单号到订单详情接口，获取商品订单详情数据。

公共参数

名称	类型	必须	描述
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版本

请求参数

请求参数：page=&tabCode=&dateBegin=&dateEnd=&buyerNick=&itemTitle=&orderId=&lastStartRow=&detail=&page_size=

参数说明：page:页码

&tabCode:[waitBuyerPay,waitSend,haveSendGoods,refunding,waitRate,success,closed,before3Months]

dateBegin:开始时间,dateEnd:结束时间(格式：yyyy-mm-dd hh:ii:ss)

buyerNick:买家昵称，如不填写则为当前登录用户

itemTitle:宝贝标题

orderId:订单编号

lastStartRow:查三个月前订单用到的参数

detail:此参数高级用户才支持

token:SaaS授权

如何获得此API

请求示例

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://服务器地址/taobao/seller_order_list/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&page=&tabCode=&dateBegin=&dateEnd=&buyerNick=&itemTitle=&orderId=&lastStartRow=&detail=&page_size=";
        JSONObject json = getRequestFromUrl(url);
        System.out.println(json.toString());
    }

}