最近因为工作的需要，对接了国内四大厂商应用商店的API，获取广告投放数据，针对四大厂商的OpenAPI实现方案进行分析。帮忙我们设计一个优雅的openapi。

1.华为应用商店的OpenAPI对接方案

1.1华为采用Oauth2.0中的客户端模式来获取Token

请求示例

POST /api/oauth2/v1/token
Host: connect-api.cloud.huawei.com
Content-Type: application/json
{
   "grant_type":"client_credentials",
   "client_id":"26********20",
   "client_secret":"************************"
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
    "access_token": "eyJhbGciOiJIUzU****************",    
    "expires_in": 172800
}

调用示例

public static String getToken(String domain, String clientId, String clientSecret) {
    String token = null;
    try {
        HttpPost post = new HttpPost(domain + "/oauth2/v1/token");

        JSONObject keyString = new JSONObject();
        keyString.put("client_id", "18893***83957248");
        keyString.put("client_secret", "B15B497B44E080EBE2C4DE4E74930***52409516B2A1A5C8F0FCD2C579A8EB14");
        keyString.put("grant_type", "client_credentials");

        StringEntity entity = new StringEntity(keyString.toString(), Charset.forName("UTF-8"));
        entity.setContentEncoding("UTF-8");
        entity.setContentType("application/json");
        post.setEntity(entity);

        CloseableHttpClient httpClient = HttpClients.createDefault();
        HttpResponse response = httpClient.execute(post);
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == HttpStatus.SC_OK) {

            BufferedReader br =
                new BufferedReader(new InputStreamReader(response.getEntity().getContent(), Consts.UTF_8));
            String result = br.readLine();
            JSONObject object = JSON.parseObject(result);
            token = object.getString("access_token");
        }

        post.releaseConnection();
        httpClient.close();
    } catch (Exception e) {

    }
    return token;
}

1.2通过API查询广告子任务统计报表

请求示例

POST https://connect-api.cloud.huawei.com/api/marketing-api/v1/report/ad/subtask
Content-type: application/json
Authorization: Bearer ***
client_id:***

{
    "startDate":"2021-09-14",
    "endDate":"2021-09-14",
    "groupby": [
        "statDate",
        "taskId",
        "subTaskId"
    ],
    "filtering": {
        "taskIds": [
            "101153900"
        ],
        "subTaskIds": [
            "1437676090851860480"
        ]
    }
}

响应示例

{
    "code": 20770001,
    "msg": "",
    "total": 1,
    "datas": [{
        "statDate": "2021-09-14",
        "taskId": 101153900,
        "subTaskId": "1437676090851860480",
        "cost": 180,
        "show": 0,
        "exposure": 120,
        "click": 50,
        "clickRate": 0.42,
        "download": 31,
        "downloadRate": 0.26,
        "downloadAverageCost":  5.8,
        "conversions": [
          {
             "conversionBehaviorId": "123",
             "conversionCount": 6,
             "conversionRate": 0.3,
             "conversionAvgPrice": 6.6
          }
        ]
    }]
}

调用示例

Curl

curl -X POST https://connect-api.cloud.huawei.com/api/marketing-api/v1/report/ad/subtask -H "Authorization:Bearer ***" -H "client_id:***" -H "Content-type: application/json"-d '{"startDate":"2021-04-06","endDate":"2021-04-20"}'

1.3华为实现方案分析

该实现方案是目前最流行的实现方案，目前阿里，腾讯，百度都使用该方案来作为API的对接方案。

2.OPPO应用商店的OpenAPI对接方案

2.1OPPO应用商店的API对接是通过SDK来对接的，官方提供操作的SDK

如何安装运行

• 我们推荐用Maven的方式管理我们的Java SDK，可以添加如下XML内容到您项目的pom.xml中

    com.heytap.ads.omni
    omni-api-sdk
    1.0.2
    OPPO Omni API SDK

如何使用

SDK数组参数调用的方法名与API接口一一对应，如v3/ad/get接口就对应OmniAds.getInstance().ads().v3AdGet()方法。

2.2使用SDK-DEMO示例(根据配置类型获取配置项示例)

/**
 * 根据配置类型获取配置项
 */
public class V3CommunalConfigGetList {
    //定义omniAds
    public OmniAds omniAds;
    //注意：owner_id是Long类型，传入的参数结尾要加“L”
    private final static Long OWNER_ID = 分配到的owner_id;
    //API授权接入方唯一身份标识；
    private final static String API_ID = 分配的apiId;
    //开通API授权后获得的私钥，在开通授权邮件中会与app_id一块提供；
    private final static String API_KEY = 分配的apiKey;
    //重要提示：返回类型暂定ResultDto