对接淘宝公共平台API

2023-05-16

1.说明

由于项目临时提出需求，需要对接淘宝公共平台查询用户的一些信息，所以需要和淘宝平台做对接，我查看了一下淘宝公共平台开发文档，虽然写的挺丰富挺整洁，但我还是一头雾水，业务流程相对复杂，经过多次查看和尝试接口文档调用，终于是花了周末两天的是将搞定了，不得不记录一下，希望下次不要再采坑，也希望对需要对接淘宝平台的小伙伴们有一些帮助，不要花费不必要的时间在踩坑的路上.

淘宝开放平台地址：开放平台-文档中心 taobao.tbk.dg.cpa.activity.report( 淘宝客-推广者-任务奖励效果报表 )

2.踩坑

看这里有详细的API说明，下面还有一大堆参数说明和调用示例，但我还是踩坑了

这是使用淘宝SDK的请求示例

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgCpaActivityReportRequest req = new TbkDgCpaActivityReportRequest();
req.setEventId(1L);
req.setBizDate("20210818");
req.setPageNo(1L);
req.setQueryType(1L);
req.setPageSize(10L);
req.setPid("mm_123_123_123");
req.setRelationId(100L);
TbkDgCpaActivityReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

最开始使用的是这个开放平台-文档中心

还是有一些区别的，这里显示推广者不需要token而我了带token的

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScCpaActivityReportRequest req = new TbkScCpaActivityReportRequest();
req.setEventId(1L);
req.setBizDate("20210818");
req.setPageNo(1L);
req.setQueryType(1L);
req.setPageSize(10L);
req.setPid("mm_123_123_123");
req.setRelationId(100L);
TbkScCpaActivityReportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

因为在调用时候发现 client.execute(req, sessionKey)方法一个参数不带sessionKey会有问题，显然我的SDK里面没有这个方法，所以下面重点讲解带token的方式

3.解决方案

既然需要token那就要看看怎样获取到token ,这里的session就是我们想要的sessionKey

点击进去开放平台-文档中心

这里也会有详细的介绍

1.创建应用

这里不做过多说明，跟着文档就可以

2.获取授权code

拼接url访问在跳转页会返回一个连接带code参数就是我们需要的code,详细的参数也可以在文档中看到

3.获取token

拿到上一步获取到的code就可以获取到访问token，这个是示例，按照这种方式的确可以获取到，在实际应用时候稍作修改就行了

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import com.taobao.api.internal.util.WebUtils; //引用top sdk
 public class open_oauth {
    public static void main(String[] args) {
      String url="https://oauth.taobao.com/token";
      Map<String,String> props=new HashMap<String,String>();
      props.put("grant_type","authorization_code");
/*测试时，需把test参数换成自己应用对应的值*/
      props.put("code","test");
      props.put("client_id","test");
      props.put("client_secret","test");
      props.put("redirect_uri","http://www.test.com");
      props.put("view","web");
      String s="";
      try{s=WebUtils.doPost(url, props, 30000, 30000);
      System.out.println(s);
      }catch(IOException e){
          e.printStackTrace();}
    } }

下面是我写的测试

@GetMapping("/tb-report")
    public String tbCpaReport(@RequestParam Map<String,String> map) throws ApiException {
        String url = "https://eco.taobao.com/router/rest";

        String appKey = map.get("appKey");
        String secret =map.get("secret");
        String date =map.get("date");
        String pid =map.get("pid");
        String eventId =map.get("eventId");

        String token = openAuth(map);

        TaobaoClient client = new DefaultTaobaoClient(url, appKey, secret);
        TbkDgCpaActivityReportRequest request = new TbkDgCpaActivityReportRequest();

        request.setEventId(Long.parseLong(eventId));
        request.setBizDate(date);
        request.setPageNo(1L);
        request.setQueryType(1L);
        request.setPageSize(10L);
        request.setPid(pid);
        request.setRelationId(100L);
        TbkDgCpaActivityReportResponse response = client.execute(request,token);

        System.out.println(response.getBody());

        return response.getBody();
    }


@GetMapping("/open-auth")
    public String openAuth(@RequestParam Map<String,String> map){

        String code =map.get("code") ;
        String redisKey = "tb-token-"+code;
        String accessToken = (String) redisUtils.get(redisKey);
        if(null!=accessToken&&!"".equals(accessToken)){
            return accessToken;
        }

        String appKey = map.get("appKey");
        String secret =map.get("secret");
        String url="https://oauth.taobao.com/token";
        Map<String,String> props=new HashMap<String,String>();
        props.put("grant_type","authorization_code");
        /*测试时，需把test参数换成自己应用对应的值*/
        props.put("code",code);
        props.put("client_id",appKey);
        props.put("client_secret",secret);
        props.put("redirect_uri","https://hhmt-tb.yoqu.net/v2/taobao/code");
        props.put("view","web");
        String s="";

        try{s=WebUtils.doPost(url, props, 30000, 30000);
            JSONObject json =  JSONObject.parseObject(s);
            accessToken = (String) json.get("access_token");
            redisUtils.set(redisKey,accessToken,1800L,TimeUnit.SECONDS);

        }catch(IOException exception){
            exception.printStackTrace();}
        return accessToken;
    }

需要注意的是要自己保存code和token,因为一个code只能获取一次token,而且token有效时间是半小时，所有这里我选择保存在redis里面

4.测试

pid参数可以查到具体的某一个推广位，如果不加就是查所有。因为只是测试，所有这里没有写分页参数，代码中也没有校验逻辑。需要的小伙伴可以在这个基础上做更改。

4.总结

先读文档在测试，实在不行就百度，CSDB，B站

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)