createFile
    • PDF

    createFile

    • PDF

    기사 요약

    파일을 업로드 할 수 있는 기능을 제공합니다.

    업로드된 파일의 fileId는 업로드 후 24시간 동안 재사용할 수 있습니다.

    24시간이 경과하면 업로드된 파일은 삭제되며 fileId도 유효하지 않게 됩니다.

    POST https://mail.apigw.fin-ntruss.com/api/v1/files
    

    요청

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    fileListYesFile다음의 확장자 파일은 첨부되지 않음 (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"
        }
      ]
    }
    

    속성

    항목필수 여부타입제약사항설명
    tempRequestIdYesString임시 요청 ID (삭제/조회 시 사용)
    filesYesList<AttachFile>파일 목록

    에러 코드

    HTTP Status Code리턴 코드응답 메시지
    40077101로그인 정보 오류
    40077102BAD_REQUEST
    40077103리소스가 존재하지 않음
    40377201권한 없음
    40377202Email 상품 사용신청 하지 않음
    40577001METHOD_NOT_ALLOWED
    41577002UNSUPPORTED_MEDIA_TYPE
    50077301기본 프로젝트가 존재하지 않음
    50077302외부 시스템 API 연동 오류
    50077303그외 INTERNAL_SERVER_ERROR

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.