电商API接口-电商OMS不可或缺的一块调用代码展示

太过爱你忘了你带给我的痛 2024-03-26 18:13 92阅读 0赞

电商后台管理系统关键的一环就是实现电商平台数据的抓取，以及上下架商品、订单修改等功能的调用。这里就需要调用电商API接口。接入电商API接口后再根据自我的需求进行功能再开发，实现业务上的数字化管理。

其中订单管理模板上需要用到如下API:

*  seller\_order\_list获取卖出的商品订单列表

*  seller\_order\_detail获取卖出的商品订单详情

*  seller\_order\_address获取卖出的商品订单地址

*  seller\_order\_close卖家关闭一笔交易

*  seller\_order\_message获取或修改卖出去的订单备注

*  seller\_order\_send订单发货

调用代码展示 [进入测试][Link 1]

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-vx15870092527.cn/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());
 }
 
 }

公共参数

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:160px;vertical-align:bottom;height:52px;">名称</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">类型</td> 
 <td style="width:160px;vertical-align:bottom;height:52px;">必须</td> 
 <td style="width:321px;vertical-align:bottom;height:52px;">描述</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">key</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用key（必须以GET方式拼接在URL中）</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">secret</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">调用密钥</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">api_name</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">是</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">cache</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">result_type</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">lang</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td style="width:160px;vertical-align:top;height:52px;">version</td> 
 <td style="width:80px;vertical-align:top;height:52px;">String</td> 
 <td style="width:160px;vertical-align:top;height:52px;">否</td> 
 <td style="width:321px;vertical-align:top;height:52px;">API版本</td> 
 </tr> 
 </tbody> 
</table>

错误码解释

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:184px;vertical-align:bottom;height:52px;">状态代码(error_code)</td> 
 <td style="width:257px;vertical-align:bottom;height:52px;">状态信息</td> 
 <td style="width:281px;vertical-align:bottom;height:52px;">详细描述</td> 
 <td style="width:80px;vertical-align:bottom;height:52px;">是否收费</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">0000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">success</td> 
 <td style="width:281px;vertical-align:top;height:52px;">接口调用成功并返回相关数据</td> 
 <td style="width:80px;vertical-align:top;height:52px;">是</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">2000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Search success but no result</td> 
 <td style="width:281px;vertical-align:top;height:52px;">接口访问成功，但是搜索没有结果</td> 
 <td style="width:80px;vertical-align:top;height:52px;">是</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Server internal error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">服务器内部错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4001</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Network error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">网络错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4002</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Target server error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">目标服务器错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4003</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Param error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">用户输入参数错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4004</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Account not found</td> 
 <td style="width:281px;vertical-align:top;height:52px;">用户帐号不存在</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4005</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Invalid authentication credentials</td> 
 <td style="width:281px;vertical-align:top;height:52px;">授权失败</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4006</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API stopped</td> 
 <td style="width:281px;vertical-align:top;height:52px;">您的当前API已停用</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4007</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Account stopped</td> 
 <td style="width:281px;vertical-align:top;height:52px;">您的账户已停用</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4008</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API rate limit exceeded</td> 
 <td style="width:281px;vertical-align:top;height:52px;">并发已达上限</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4009</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API maintenance</td> 
 <td style="width:281px;vertical-align:top;height:52px;">API维护中</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4010</td> 
 <td style="width:257px;vertical-align:top;height:52px;">API not found with these values</td> 
 <td style="width:281px;vertical-align:top;height:52px;">API不存在</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4012</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Please add api first</td> 
 <td style="width:281px;vertical-align:top;height:52px;">请先添加api</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4013</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Number of calls exceeded</td> 
 <td style="width:281px;vertical-align:top;height:52px;">调用次数超限</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4014</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Missing url param</td> 
 <td style="width:281px;vertical-align:top;height:52px;">参数缺失</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4015</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Wrong pageToken</td> 
 <td style="width:281px;vertical-align:top;height:52px;">参数pageToken有误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4016</td> 
 <td style="width:257px;vertical-align:top;height:52px;">Insufficient balance</td> 
 <td style="width:281px;vertical-align:top;height:52px;">余额不足</td> 
 <td style="width:80px;vertical-align:top;height:52px;">忽略</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">4017</td> 
 <td style="width:257px;vertical-align:top;height:52px;">timeout error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">请求超时</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 <tr> 
 <td style="width:184px;vertical-align:top;height:52px;">5000</td> 
 <td style="width:257px;vertical-align:top;height:52px;">unknown error</td> 
 <td style="width:281px;vertical-align:top;height:52px;">未知错误</td> 
 <td style="width:80px;vertical-align:top;height:52px;">否</td> 
 </tr> 
 </tbody> 
</table>

[Link 1]: https://o0b.cn/jennif