파일 업로드
업로드 스트림에 파일 데이터를 멀티파트 방식으로 전송합니다. open-upload-stream으로 발급받은 토큰을 사용하며, 같은 토큰으로 여러 번 호출하여 청크를 이어 전송할 수 있습니다.
필요 권한
유효한 업로드 토큰이 있으면 게스트도 호출할 수 있습니다.
HTTP 요청
POST /api/sonar/upload
요청은 multipart/form-data 형식으로 전송해야 합니다.
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-F token=a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-F file=@users.csv \
-X POST https://HOSTNAME/api/sonar/upload
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| token | O | 문자열 | GUID 형식의 업로드 스트림 식별자 | 36자 |
| file | O | 파일 | 업로드할 파일 청크 | 멀티파트 전송 필수 |
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "token should be not null"
}
업로드 스트림이 존재하지 않거나 만료된 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "upload-stream-not-found"
}