이미지 파일

메시지 발송에 필요한 이미지 파일을 관리 합니다.

  • 이미지 파일 사전 등록 후 이미지 메시지(MMS, RCS, 친구톡)를 전송 할 수 있습니다.

  • 등록된 이미지 파일은 발급 된 파일키 또는 이미지 URL로 유효기간까지 재사용 할 수 있습니다.

  • 서비스 타입별 지원하는 이미지 파일 종류는 여기를 참고해 주십시오.

  • 등록하는 이미지 파일명은 최대 40자 까지이며 영문,숫자를 권장합니다.

multipart/form-data 형태로 요청합니다.

curl -X POST https://omni.ibapi.kr/v1/file/MMS \
-H "Accept: application/json" \
-H "Authorization:Bearer 발급받은 토큰" \
-F file=@파일경로/파일명.jpg

Request

Header

Path Parameter

Body

Response

Header

Body

참고사항

서비스 별 지원 이미지 파일(Filename extension) 사양
  • MMS

    • 이미지 형식: jpg(jpeg)

    • 제한 사이즈: 가로 1,500 세로 1,440 이하

    • 최대 파일 용량: 300KB

  • RCS

    • 이미지 형식: jpg(jpeg), bmp, png, gif

    • 최대 파일 용량: 1MB

  • FRIENDTALK

    • 이미지 형식: jpg(jpeg), png

    • 제한 사이즈

      • 친구톡 이미지: 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하

      • 친구톡 와이드 이미지: 가로 800px 세로 600px 고정

      • 친구톡 와이드 아이템 리스트 이미지: 가로 400px, 세로 400px ~ 가로 800px~세로 400px

      • 친구톡 케러셀 이미지: 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하

    • 최대 파일 용량: 500KB(친구톡), 2MB(친구톡 와이드, 친구톡 아이템 리스트, 친구톡 캐러셀)