업로드 스트림 생성

파일 업로드를 위한 새 업로드 스트림을 생성합니다. 발급받은 토큰으로 파일 업로드 API를 호출하여 파일을 전송할 수 있습니다.

필요 권한

게스트 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

POST /api/sonar/upload-streams

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d handler_name=sonar-app \
     -d file_name=sample-app.pkg \
     -d file_size=10485760 \
     -X POST \
     https://HOSTNAME/api/sonar/upload-streams

요청 매개변수

요청 본문 매개변수

키	필수	타입	설명	비고
handler_name	O	문자열	업로드 핸들러 이름	예: `sonar-app`, `lookup`
file_name	O	문자열	파일 이름
file_size	O	64비트 정수	파일 크기	바이트 단위
metadata	X	문자열 키/값	메타데이터	JSON 형식 문자열

정상 응답

{
  "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

token (문자열): 생성된 업로드 스트림 토큰 (36자 GUID)

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "handler_name should be not null"
}