上传人群包文件

需要携带 Token，详情看 Token

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

文件要求: 格式支持 txt, csv, gz(里面被打包的文件是 txt 或 csv, 即 .txt.gz 或者 .csv.gz) 最大文件大小限制是 5G

请求地址

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

请求方法

GET

请求示例

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	json	成功，返回数据，失败返回具体的错误信息
area_type	int	数据集群 1:非中国大陆地区, 2:中国大陆地区
file_name	int	文件名称
file_md5	int	文件 MD5
ttl	int	有效时间(单位:秒)
method	json	上传文件到 s3 的请求方法
url	string	上传文件到 s3 的请求 URL
data_path	string	上传文件到 s3 的完整路径, 用于创建人群包

area_type=1 的应答示例

{
    "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 的示例

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"

area_type=2 的响应结果

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

area_type=2 的应答示例

{
    "code": 200,
    "message": "success",
    "data": {
        "area_type": 2,
        "file_name": "test.txt",
        "file_md5": "1ceada6012b007afb4b0a29984660ad0",
        "ttl": 300,
        "oss": {
            "method": "{data.oss.method}",
            "accessid": "{data.oss.accessid}",
            "host": "{data.oss.host}",
            "expire": 1704892428,
            "signature": "{data.oss.signature}",
            "policy": "{data.oss.policy}",
            "dir": "{data.oss.dir}",
            "data_path": "{data.oss.data_path}"
        }
    }
}

area_type=2 上传文件到 oss 的示例

curl --request {data.oss.method} '{data.oss.host}' \
--form 'key="{data.oss.dir}"' \
--form 'OSSAccessKeyId="{data.oss.accessid}"' \
--form 'policy="{data.oss.policy}"' \
--form 'signature="{data.oss.signature}"' \
--form 'success_action_status="200"' \
--form 'file=@"{path_to_file}"'

例如:

请求预签名接口返回的预签名信息
{data.oss.method} = POST
{data.oss.host} = https://upload.cn.aliyuncs.com
{data.oss.dir} = dir/audience.txt
{data.oss.accessid} = accessid123
{data.oss.policy} = policy456
{data.oss.signature} = signature789

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

curl --request POST 'https://upload.cn.aliyuncs.com' \
--form 'key="dir/audience.txt"' \
--form 'OSSAccessKeyId="accessid123"' \
--form 'policy="policy456"' \
--form 'signature="signature789"' \
--form 'success_action_status="200"' \
--form 'file=@"/path/to/file"'