# U-DOP 数据开放平台 OpenAPI

> 鉴权方式：`aliyun-aksk`（ACS3-HMAC-SHA256 V3 签名）
> Endpoint：`https://dop.openapi.umeng.com`
> API Version：`2022-11-30`

## 调用格式

```bash
umeng-cli call '{
  "name": "dop.<Action>",
  "api": {
    "method": "<METHOD>",
    "baseUrl": "https://dop.openapi.umeng.com",
    "endpoint": "/dop/<path>",
    "authType": "aliyun-aksk",
    "version": "2022-11-30"
  }
}' '<参数JSON>'
```

- `action` 可省略，自动从 `endpoint` 路径最后一段推导（首字母大写）
- 所有接口均为 `GET` 方法

---

## 接口路由表

| Action | 说明 | Method | Pathname |
|--------|------|--------|----------|
| `GetOssMetaList` | 获取 OSS 元数据列表 | GET | `/dop/getOssMetaList` |
| `GetOssMetaDownload` | 获取 OSS 元数据下载地址 | GET | `/dop/getOssMetaDownload` |
| `SubmitBackfill4Api` | 提交数据回流任务 | GET | `/dop/submitBackfill4Api` |

---

## 接口详情

### GetOssMetaList — 获取 OSS 元数据列表

查询可用的数据导出文件列表。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| appkey | string | 是 | 应用 appkey |
| date | string | 否 | 查询日期（例如: 2025-01-01） |
| page | number | 否 | 页号，从 1 开始 |
| pageSize | number | 否 | 每页显示数量 |

```bash
umeng-cli call '{
  "name": "dop.GetOssMetaList",
  "api": {
    "method": "GET",
    "baseUrl": "https://dop.openapi.umeng.com",
    "endpoint": "/dop/getOssMetaList",
    "authType": "aliyun-aksk",
    "version": "2022-11-30"
  }
}' '{"appkey":"your_appkey"}'
```

---

### GetOssMetaDownload — 获取 OSS 元数据下载地址

获取指定元数据文件的下载链接。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| appkey | string | 是 | 应用 appkey |
| taskId | string | 是 | 任务 ID（从 GetOssMetaList 获取） |

```bash
umeng-cli call '{
  "name": "dop.GetOssMetaDownload",
  "api": {
    "method": "GET",
    "baseUrl": "https://dop.openapi.umeng.com",
    "endpoint": "/dop/getOssMetaDownload",
    "authType": "aliyun-aksk",
    "version": "2022-11-30"
  }
}' '{"appkey":"your_appkey","taskId":"your_task_id"}'
```

---

### SubmitBackfill4Api — 提交数据回流任务

提交数据回流任务，将友盟统计数据回流到指定的存储。

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| appkey | string | 是 | 应用 appkey |
| startDate | string | 是 | 起始日期（例如: 2025-01-01） |
| endDate | string | 是 | 截止日期（例如: 2025-01-07） |

```bash
umeng-cli call '{
  "name": "dop.SubmitBackfill4Api",
  "api": {
    "method": "GET",
    "baseUrl": "https://dop.openapi.umeng.com",
    "endpoint": "/dop/submitBackfill4Api",
    "authType": "aliyun-aksk",
    "version": "2022-11-30"
  }
}' '{"appkey":"your_appkey","startDate":"2025-01-01","endDate":"2025-01-07"}'
```
