업로드
- 인쇄
- PDF
업로드
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
설명
첨부 파일을 업로드한다.
요청 헤더 공통
| Header | Description |
|---|---|
| x-ncp-apigw-timestamp | - 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 - API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 |
| x-ncp-iam-access-key | - 네이버 클라우드 플랫폼 포털 또는 Sub Account에서 발급받은 Access Key ID |
| x-ncp-apigw-signature-v2 | - 위 예제의 Body를 Access Key ID와 맵핑되는 Secret Key로 암호화한 서명 - HMAC 암호화 알고리즘은 HmacSHA256 사용 |
첨부파일 업로드 API
첨부파일을 건별 업로드한다. (최대 사이즈 ; 100MB)
요청 URL
POST
https://workplace.apigw.ntruss.com/common/apigw/v1/file/company/{companyId}
요청 Path 파라미터
| 파라미터 | 타입 | 크기 | 필수 여부 | 설명 |
|---|---|---|---|---|
| companyId | String | 36 | Y | 조회할 고객사의 연동키(CompanyId) Developers > 기본 설정 > 연동키 |
요청 Body 파라미터
| 파라미터 | 타입 | 크기 | 필수 여부 | 설명 |
|---|---|---|---|---|
| file | File | 100MB | Y | 첨부파일 |
요청 예시
POST https://workplace.apigw.ntruss.com/common/apigw/v1/file/company/e770da21-d7d9-405a-9bfc-9da400e13d38
POST /common/apigw/v1/file/company/e770da21-d7d9-405a-9bfc-9da400e13d38
HOST: workplace.apigw.ntruss.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZugW
x-ncp-apigw-timestamp: 1505290625682
x-ncp-apigw-api-key: DUxjP4HYTP8V7khBkgywdDHQjKuaYWGrppHKpvdv
x-ncp-iam-access-key: D78BB444D6D3C84CA38A
x-ncp-apigw-signature-v1: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=
응답 예시
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2020 01:18:11 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68d1o68pm4cr63gc3169gm4p34
응답
HTTP 상태 코드로 리턴되고 Body 정보로 전달한다.
| HTTP 상태 코드 | 응답 메시지 | 설명 |
|---|---|---|
| 200 | OK | 일반적인 요청 성공 |
| 201 | Created | 리소스 생성 성공에 대한 응답 코드 |
| 400 | Bad Request | 일반적인 요청 실패에 사용 |
| 500 | Internal Server Error | - 일반적인 서버 오류에 대한 응답 코드 - 4XX대의 오류 코드: 클라이언트 측 오류 표시 - 5XX대의 오류 코드: 서버 측 오류 표시 |
응답 예시
HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2020 01:18:11 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 6apj66ssmad1l64dpj6gp32d9h
{
"fileId": "3d799913-3ed8-4771-8620-4cbf88e66aee",
"tenantId": "e770da21-d7d9-405a-9bfc-9da400e13d38",
"companyId": "e770da21-d7d9-405a-9bfc-9da400e13d38",
"fileStat": "TMP",
"fileNm": "아카이브 2.zip",
"fileSz": 36569809,
"creYmdt": 1661156834137
}이 문서가 도움이 되었습니까?