对接抖店API-03 获取订单列表

官方文档 : 抖店开放平台

DOUDIAN_URL :https://openapi-fxg.jinritemai.com

如果前面获取accessToken 和签名都完成了, 那获取订单会简单很多,毕竟已经熟悉了需要的数据结构。

订单列表中只需要注意一下参数排序问题,分页过程就行, 因为接口返回的数据只有100条 ,所以需要多次请求, 跟分页查询类似,只到你查到想要的所有数据 ,然后在存在本地。

/***************************************   订单详情查询     **********************************/
    public void searchList(Integer day, PlatformManagementStore store) {
        String method = "order.searchList";
        String methodStrUrl = "/order/searchList";
        String shopId = store.getShopId();
        //之前获取到的token
        //从redis获取
        if (redisUtils.hasKey("tikTokAccessToken" + shopId)) {
            accessToken = redisUtils.get("tikTokAccessToken" + shopId).toString();
        } else {
            JSONObject data = tokenCreate(shopId);
            if (null == data || "".equals(data)) {
                System.out.println("accessToken为空,请检查请求API是否正常获取到");
                return;
            }
            accessToken = data.getString("access_token");
            String expires_in = data.getString("expires_in");
            redisUtils.set("tikTokAccessToken" + shopId, accessToken, Long.valueOf(expires_in));
        }


        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String time = simpleDateFormat.format(new Date());

        //参数加密
        JSONObject param_json = new JSONObject(true);

        //当前时间
        Date now = DateUtils.getNowDate();
        //day天之前
        Calendar calendar = DateUtils.toCalendar(now);
        calendar.add(Calendar.DATE, -day);
        long endTime = now.getTime();
        long beginTime = calendar.getTimeInMillis();
        //下单结束时间
        param_json.put("create_time_end", String.valueOf(endTime / 1000));
        //下单开始时间
        param_json.put("create_time_start", String.valueOf(beginTime / 1000));
        //分页
        param_json.put("page", page.toString());
        param_json.put("size", pageSize.toString());

        //获取签名
        String sign = fetchSign(method, param_json.toString(), time);

        //地址后的参数
        StringBuffer param = new StringBuffer();
        param.append("app_key").append("=").append(APP_KEY).append("&");
        param.append("method").append("=").append(method).append("&");
        param.append("access_token").append("=").append(accessToken).append("&");
        param.append("param_json").append("=").append(param_json).append("&");
        param.append("timestamp").append("=").append(time).append("&");
        param.append("v").append("=").append("2").append("&");
        param.append("sign").append("=").append(sign).append("&");

        // 发送请求
        String response = HttpUtils.sendPost(DOUDIAN_URL + methodStrUrl, param.toString());

        JSONObject jsonObject = JSONObject.parseObject(response);
        if (jsonObject.getIntValue("err_no") == 0) {
            JSONObject data = jsonObject.getJSONObject("data");
            String shopOrderList = data.getString("shop_order_list");
            List<TiktokOrder> tiktokOrders = JSON.parseArray(shopOrderList, TiktokOrder.class);

            //获取对象
            tiktokOrderList.addAll(tiktokOrders);
            try {
                if (tiktokOrders.size() == pageSize) {
                    page++;
                    //由于有分页迭代获取订单
                    searchList(day, store);
                } else {
                    //创建订单列表, 订单详细, 订单地址三个List
                    List<TiktokOrder> orderList = new ArrayList<>();
                    List<TiktokOrderDetail> orderDetailList = new ArrayList<>();
                    List<TiktokOrderAddress> orderAddressList = new ArrayList<>();
                    //迭代完毕后再保存
                    System.out.println("解析订单成功");
                    for (TiktokOrder order : tiktokOrderList) {
                        //判断订单状态 2备货中
                        if (null == order || order.getOrderStatus() != 2) {
                            continue;
                        }
                        // 查询订单详情接口
                        skuOrderDetailList = orderDetail(order.getOrderId(), shopId);
                        if (null != skuOrderDetailList && skuOrderDetailList.size() > 0) {
                            for (TiktokOrderDetail detail : skuOrderDetailList) {
                                detail.setParentOrderId(order.getOrderId());
                                orderDetailList.add(detail);
                            }
                            skuOrderDetailList = null;
                        }
                        //保存订单地址
                        List<TiktokOrderAddress> addressList = order.getPostAddr();
                        for (TiktokOrderAddress address : addressList) {
                            address.setOrderId(order.getOrderId());
                            orderAddressList.add(address);
                        }

                        /**
                         * 保存关于店铺的信息
                         */
                        order.setStoreName(store.getStoreName());
                        order.setStoreId(store.getStoreId());
                        order.setStoreCode(store.getStoreCode());
                        //保存订单
                        orderList.add(order);
                    }
                    
                    //执行保存到数据库操作
                    if (null != orderList && orderList.size() > 0) {
                        tiktokOrderService.batchInsertTiktokOrder(orderList);
                    }
                    if (null != orderDetailList && orderDetailList.size() > 0) {
                        tiktokOrderDetailService.batchInsertTiktokOrderDetail(orderDetailList);
                    }
                    if (null != orderAddressList && orderAddressList.size() > 0) {
                        tiktokOrderAddressService.batchInsertTiktokOrderAddress(orderAddressList);
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                //这个步骤好像是不用的 ,可以移除
                page = 0;
                tiktokOrderList = new ArrayList<>();
            }
        }






/***************************************   获取订单详情接口     **********************************/
    public List<TiktokOrderDetail> orderDetail(String shopOrderId, String shopId) {
        //如果之前存储过 ,则不继续存储订单详情
        String method = "order.orderDetail";
        String methodStrUrl = "/order/orderDetail";
        //之前获取到的token
        //从redis获取
        if (redisUtils.hasKey("tikTokAccessToken" + shopId)) {
            accessToken = redisUtils.get("tikTokAccessToken" + shopId).toString();
        } else {
            JSONObject data = tokenCreate(shopId);
            if (null == data || "".equals(data)) {
                System.out.println("accessToken为空,请检查请求API是否正常获取到");
                return null;
            }
            accessToken = data.getString("access_token");
            String expires_in = data.getString("expires_in");
            redisUtils.set("tikTokAccessToken" + shopId, accessToken, Long.valueOf(expires_in));
        }


        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String time = simpleDateFormat.format(new Date());

        //参数加密
        JSONObject param_json = new JSONObject(true);
        //订单id - orderID
        param_json.put("shop_order_id", shopOrderId);

        //获取签名
        String sign = fetchSign(method, param_json.toString(), time);

        //地址后的参数
        StringBuffer param = new StringBuffer();
        param.append("app_key").append("=").append(APP_KEY).append("&");
        param.append("method").append("=").append(method).append("&");
        param.append("access_token").append("=").append(accessToken).append("&");
        param.append("param_json").append("=").append(param_json).append("&");
        param.append("timestamp").append("=").append(time).append("&");
        param.append("v").append("=").append("2").append("&");
        param.append("sign").append("=").append(sign);

        // 发送请求
        String response = HttpUtils.sendPost(DOUDIAN_URL + methodStrUrl, param.toString());

        JSONObject jsonObject = JSONObject.parseObject(response);
        if (jsonObject.getIntValue("err_no") == 0) {
            JSONObject data = jsonObject.getJSONObject("data").getJSONObject("shop_order_detail");
            if (null != data && data.size() > 0) {
                String skuOrderList = data.getString("sku_order_list");
                List<TiktokOrderDetail> tiktokOrders = JSON.parseArray(skuOrderList, TiktokOrderDetail.class);
                return tiktokOrders;
            }
        }
        return null;
    }

<think>好的,我现在需要处理用户关于Coze API飞鸽对接的请求。首先,我得确认用户的具体需求。他们想要详细的教程、实操步骤、示例代码和相关文档。接下来,我应该参考用户提供的引用内容,看看是否有相关信息可以直接使用。 引用[1]提到Coze API支持工作流、Bots、文件、知识库等的接口,但目前文档专注于工作流的API调用。引用[2]是关于Coze API的实战应用指南,可能包含注册和调用的流程。引用[3]则提供了使用Python requests库调用对话API的案例,可能有代码示例。 用户的问题涉及飞鸽的对接,但提供的引用中没有直接提到飞鸽。因此,我需要基于现有的Coze API通用步骤进行推断,并结合常见的电商API对接经验来构建答案。可能需要包括授权、API调用、数据处理等步骤。 接下来,我需要确保回答结构清晰,分步骤说明,并尽量提供示例代码,比如使用Python调用API的示例。同时,要提醒用户参考飞鸽的官方文档,因为具体的接口可能有所不同。 另外,需要注意LaTeX格式的正确使用,行内公式用$...$,独立公式用$$...$$,但当前问题不涉及数学公式,可能不需要使用。但需检查是否有其他需要格式化的内容。 最后,生成相关问题,帮助用户深入理解,比如授权机制、错误处理、消息推送等。同时,确保所有引用标注正确,比如创建授权部分引用[^1],实战指南引用[^2],Python示例引用[^3]。 需要验证步骤的逻辑是否合理,比如先创建授权,再调用API,处理响应,然后结合飞鸽的接口。示例代码部分可能需要调整,以符合Coze API的实际参数,比如替换API密钥和bot_id。 总结,回答应包括:准备工作、授权、API调用步骤、示例代码、整合飞鸽接口的注意事项,以及相关问题和参考引用。确保每个步骤清晰,示例代码正确,并提示用户查阅双方文档。</think>### Coze API飞鸽对接指南 #### 一、准备工作 1. **注册Coze开发者账号** 确保已在[Coze开放平台](https://www.coze.cn/open)完成账号注册并创建应用[^2]。 2. **获取API密钥** 在Coze控制台生成`API Key`,用于后续鉴权。示例鉴权头: ```python headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } ``` 3. **查阅飞鸽文档** 登录[开放平台](https://open.jinritemai.com/)获取飞鸽API的接口规范,重点关注消息推送、订单同步等场景。 --- #### 二、Coze API对接核心步骤 1. **创建Coze工作流** - 设计处理飞鸽消息的逻辑(如自动回复、订单查询)。 - 发布工作流并获取其`workflow_id`[^1]。 2. **调用Coze对话API** 使用Python发起请求(示例基于引用[3]调整): ```python import requests def coze_chat(user_query): url = "https://api.coze.cn/v1/chat/completions" payload = { "bot_id": "YOUR_BOT_ID", "user_id": "飞鸽用户ID", "message": user_query } response = requests.post(url, json=payload, headers=headers) return response.json()["data"]["reply"] ``` 3. **处理飞鸽消息推送** ```python # 接收飞鸽消息(示例) from flask import Flask, request app = Flask(__name__) @app.route('/feige/webhook', methods=['POST']) def handle_feige(): data = request.json user_msg = data.get("content") coze_reply = coze_chat(user_msg) # 调用飞鸽API返回消息 send_to_feige(coze_reply) return "OK" ``` --- #### 三、关键整合点 1. **鉴权同步** - Coze使用`API Key`,飞鸽常用`sign`签名验证,需在服务端实现双重鉴权。 2. **数据格式转换** ```python # 示例:转换飞鸽订单数据为Coze输入 def format_order_data(feige_data): return f"用户订单:{feige_data['order_id']},金额:{feige_data['amount']}" ``` 3. **异步任务处理** 对耗时操作(如订单查询)建议使用Coze工作流异步接口,通过`callback_url`接收结果。 --- #### 四、调试与部署 1. **本地测试** 使用`ngrok`暴露本地服务端口,在飞鸽后台配置webhook地址: ```bash ngrok http 5000 ``` 2. **日志监控** 记录Coze API与飞鸽接口的请求/响应,推荐使用`logging`模块。 ---
评论 12
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值