菜单

上传人群包文件

需要携带 Token，详情看Token

先请求预签名接口, 获取上传文件的预签名信息
根据预签名信息, 上传人群包文件

文件要求:

内容: 一列的设备 ID 值, 首行可以是不为空的任意列名
大小: 单个文件最大限制是 5GB
格式: 支持 txt, csv, gz(里面被打包的文件是 txt 或 csv, 即 .txt.gz 或者 .csv.gz)

请求地址

https://ss-api.mintegral.com/api/open/v1/audience/presigned-upload-data

请求方法

GET

请求示例

json 复制代码

GET /api/open/v1/audience/presigned-upload-data?area_type=1&file_name=test.txt&file_md5=1ceada6012b007afb4b0a29984660ad0 HTTP/1.1
Host: ss-api.mintegral.com

请求参数

字段	类型	说明	默认值	例子
area_type	int	数据集群 1:非中国大陆地区, 2:中国大陆地区	--	1
file_name	string	文件名称	--	test.txt
file_md5	string	文件 MD5	--	1ceada6012b007afb4b0a29984660ad0

area_type=1 的响应结果

字段	类型	说明
code	int	200 表示成功，其他表示失败
msg	string	成功，返回”success“，失败返回相应的错误信息
data	object	成功，返回数据，失败返回具体的错误信息
data.area_type	int	数据集群 1:非中国大陆地区
data.file_name	int	文件名称
data.file_md5	int	文件 MD5
data.ttl	int	有效时间(单位:秒)
data.s3	object	上传文件到 s3 的信息
data.s3.method	string	上传文件到 s3 的请求方法
data.s3.url	string	上传文件到 s3 的请求 URL
data.s3.data_path	string	上传文件到 s3 的完整路径, 用于创建人群包

area_type=1 的应答示例

json 复制代码

{
    "code": 200,
    "message": "success",
    "data": {
        "area_type": 1,
        "file_name": "audience_file.txt",
        "file_md5": "1ceada6012b007afb4b0a29984660ad0",
        "ttl": 300,
        "s3": {
            "method": "{data.s3.method}",
            "url": "{data.s3.url}",
            "data_path": "{data.s3.path}"
        }
    }
}

area_type=1 上传文件到 s3 的示例

json 复制代码

curl -X {data.s3.method} -T "{path_to_file}" "{data.s3.url}"

例如:

请求预签名接口返回的预签名信息
{data.s3.method} = PUT
{data.s3.url} = https://upload.s3.amazonaws.com?abc=123

你的文件地址
{path_to_file} = /path/to/file

curl -X PUT -T "/path/to/file" "https://upload.s3.amazonaws.com?abc=123"

上传成功后，使用 {data.s3.data_path} 创建人群包。

上一个

获取人群包列表

下一个

创建人群包

最近修改: 2025-07-24

大纲