createFile
- 인쇄
- PDF
createFile
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
파일을 업로드 할 수 있는 기능을 제공합니다.
업로드된 파일의 fileId는 업로드 후 24시간 동안 재사용할 수 있습니다.
24시간이 경과하면 업로드된 파일은 삭제되며 fileId도 유효하지 않게 됩니다.
POST https://mail.apigw.fin-ntruss.com/api/v1/files
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| fileList | Yes | File | 다음의 확장자 파일은 첨부되지 않음 (bat,cmd,com,cpl,exe,scr,js,vbs,ocx,pif,msi,efi,fon,drv,dll,sys,app,dmg,ipa,apk,jar,wsh,reg,hlp,lnk,wsf,scf,swf,cab) 위의 확장자 파일이 포함된 압축파일(zip, rar..)은 발송실패 할 수 있음 첨부파일은 개당 최대 10MB의 제한이 있으며, 총 20MB로 제한됨 | 업로드할 파일 |
응답
| HTTP 상태코드 | 설명 |
|---|---|
| 201 | 파일 업로드 성공 |
| 400 | 인증 실패, 잘못된 요청 |
| 500 | 서버 에러 |
예시
요청 예시
curl -X POST "https://mail.apigw.fin-ntruss.com/api/v1/files" -H "accept: application/json" -H "Content-Type: multipart/form-data" -H "x-ncp-iam-access-key: QXXXXXXXXTlvONG" -H "x-ncp-apigw-timestamp: 1634893772569" -H "x-ncp-apigw-signature-v2: bXXXXXXSDFXXXXXXXXXXXXXX/lCBMbk=" -F "fileList=@template_20211020113533.json;filename=template.json"
응답 예시
{
"tempRequestId":"f355aac1-7776-4c0b-8484-20eaa065cb65-99",
"files":[
{
"fileName":"test.txt",
"fileSize":16,
"fileId":"40fe58bd-91fe-4f89-a62e-705a7c17d65e-99"
}
]
}
속성
| 항목 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| tempRequestId | Yes | String | 임시 요청 ID (삭제/조회 시 사용) | |
| files | Yes | List<AttachFile> | 파일 목록 |
에러 코드
| HTTP Status Code | 리턴 코드 | 응답 메시지 |
|---|---|---|
| 400 | 77101 | 로그인 정보 오류 |
| 400 | 77102 | BAD_REQUEST |
| 400 | 77103 | 리소스가 존재하지 않음 |
| 403 | 77201 | 권한 없음 |
| 403 | 77202 | Email 상품 사용신청 하지 않음 |
| 405 | 77001 | METHOD_NOT_ALLOWED |
| 415 | 77002 | UNSUPPORTED_MEDIA_TYPE |
| 500 | 77301 | 기본 프로젝트가 존재하지 않음 |
| 500 | 77302 | 외부 시스템 API 연동 오류 |
| 500 | 77303 | 그외 INTERNAL_SERVER_ERROR |
이 문서가 도움이 되었습니까?