들어 오세요
메뉴

오디언스 파일 업로드하기

상태를 변경하려면 Token을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

파일 업로드에 필요한 pre-signed 정보를 받기 위해 pre-signed 요청을 시작합니다.

반환된 pre-signed 정보를 기반으로 Audience 패키지 파일을 업로드합니다.

파일 요건:

  • ​​Content​​: 디바이스 ID로 구성된 단일 열입니다. 첫 번째 행은 비어 있지 않은 임의의 헤더(예: 컬럼명)일 수 있습니다.
  • ​​Size​​: 파일당 최대 5GB입니다.
  • Format​​: txt, csv, gz를 지원합니다. 압축 파일은 txt 또는 csv여야 합니다. 즉, .txt.gz 또는 .csv.gz 형식입니다.

요청 주소

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

요청 메서드

GET

요청 예시

json Copy 
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

요청 파라미터

Fields Type Explanations Default Value Value Examples
area_type int 데이터 클러스터
1: 중국 본토 외 지역		 -- 1
file_name string 파일명 -- test.txt
file_md5 string 파일 MD5 -- 1ceada6012b007afb4b0a29984660ad0

응답 (area_type=1)

Fields Type Explanations
code int 200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg string 성공 시 “success”를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data object 성공 시 “success”를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data.area_type int 데이터 클러스터
1: 중국 본토 외 지역, 2: 중국 본토
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에 파일을 업로드하기 위한 전체 경로입니다. 다음에서 사용됩니다.
Create Audience

응답 예시 (area_type=1)

json Copy 
{
    "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)

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

예:

pre-signed 요청 인터페이스에서 반환된 pre-signed 정보
{data.s3.method} = PUT
{data.s3.url} = https://upload.s3.amazonaws.com?abc=123
{data.s3.path} = s3://s3/path/to/file

파일 경로
{path_to_file} = /path/to/file

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

업로드가 성공하면 Create Audience에 {data.s3.data_path}를 사용하세요.

이전의
오디언스 목록 조회하기
다음
오디언스 생성하기
최근 수정됨: 2026-08-06