Skip to main content
Messages API를 사용하여 메시지를 보내고, 수정하고, 삭제하고, 고정할 수 있습니다. 채널의 메시지 목록을 조회하여 기록을 읽고 수정 및 삭제 내용을 동기화하세요. 또한 이모지로 반응하고, 반응한 사람 목록을 조회하고, 투표에 한 번 투표할 수 있습니다. 각 메시지에는 반응 수와 투표 수, 그리고 본인이 반응하거나 투표했는지 여부가 표시되지만, 다른 누가 투표했는지는 표시되지 않습니다.

엔드포인트

속성

string
필수
메시지 ID로, 접두사는 post_입니다. 생성 시 id를 보낸 경우 해당 값과 일치합니다.
object[]
필수

속성

string
필수
파일 ID로, 접두사는 file_입니다.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
원본 파일의 MIME 유형으로, 예를 들어 application/pdf입니다. 모더레이션으로 파일이 삭제되어도 유지됩니다.
string
필수
파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
number | null
필수
오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
string | null
멀티파트 업로드의 ID로, complete에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형으로, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 삭제되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
string
필수
파일의 업로드 수명 주기 단계입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 존재합니다.
string | null
필수
파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 삭제된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명된 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
필수
이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
object | null
필수

속성

string
필수
사용자 ID로, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
boolean
필수
작성자가 이 커뮤니티 채널을 소유한 계정의 팀원이면 true입니다. 파트너, 비공개 및 지원 채널, 삭제된 메시지의 경우 false입니다.
string | null
필수
string
필수
string | null
필수
Markdown 콘텐츠입니다. 삭제된 메시지의 경우 null입니다.
string
필수
생성 시점으로, ISO 8601 타임스탬프입니다.
object | null
필수

속성

string | null
필수
웹훅 표시 이름이며, 사용자 이름을 사용하려면 null입니다.
object | null
필수
웹훅 프로필 이미지이며, 사용자 이미지를 사용하려면 null입니다.

속성

string
필수
파일 ID로, 접두사는 file_입니다.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
원본 파일의 MIME 유형으로, 예를 들어 application/pdf입니다. 모더레이션으로 파일이 삭제되어도 유지됩니다.
string
필수
파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
number | null
필수
오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
string | null
멀티파트 업로드의 ID로, complete에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형으로, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 삭제되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
string
필수
파일의 업로드 수명 주기 단계입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 존재합니다.
string | null
필수
파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 삭제된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명된 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
필수
이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
삭제 시점이며, 활성 메시지의 경우 null입니다.
boolean
필수
object[]
필수

속성

integer | null
필수
string | null
필수
object[]
필수

속성

boolean
필수
string
필수
string
필수
임베드 하단에 표시되는 푸터입니다. 임베드에 푸터가 없는 경우 null입니다.

속성

object | null
필수
푸터 텍스트 옆에 표시되는 작은 이미지입니다. 푸터에 아이콘이 없는 경우 null입니다.

속성

string | null
필수
integer | null
필수
string
필수
integer | null
필수
string
필수
object | null
필수

속성

string | null
필수
integer | null
필수
string
필수
integer | null
필수
object | null
필수

속성

string | null
필수
integer | null
필수
string
필수
integer | null
필수
string | null
필수
임베드 작성자가 제공한 시간으로, UTC 기준 ISO 8601 타임스탬프입니다. 없거나 유효하지 않은 경우 null입니다.
string | null
필수
string | null
필수
object[]
필수
메시지에 첨부된 GIF입니다. 삭제된 메시지의 경우 비어 있습니다.

속성

integer
필수
original_url의 높이(픽셀)입니다.
string
필수
원본 크기 GIF입니다. Klipy 미디어 호스트의 HTTPS URL입니다.
string
필수
미리보기 및 플레이스홀더용 작은 버전입니다. Klipy 미디어 호스트의 HTTPS URL입니다.
string
필수
GIF의 식별자입니다.
string
필수
GIF 제목입니다.
string
필수
메시지가 GIF를 렌더링하는 URL입니다. Klipy 미디어 호스트의 HTTPS URL입니다.
integer
필수
original_url의 너비(픽셀)입니다.

속성

string | null
필수
페이지 설명이며, 사용할 수 없는 동안에는 null입니다.
string | null
필수
사이트 아이콘 URL이며, 사용할 수 없는 경우 null입니다.
추가 미리보기 정보이며, 사용할 수 없는 경우 null입니다.

속성

string | null
필수
string
필수
string
필수
string | null
필수
미리보기 이미지 URL이며, 사용할 수 없는 경우 null입니다.
boolean
필수
서버가 아직 이 미리보기를 생성 중인지 여부입니다.
string | null
필수
페이지 제목이며, 사용할 수 없는 동안에는 null입니다.
string
필수
미리보기 대상 URL입니다.
string[]
필수
string
필수
사용 가능한 옵션: regular, system, automated
boolean
필수
string | null
필수
서식이 없는 메시지 텍스트입니다. 텍스트가 없거나 메시지가 삭제된 경우 null입니다.
object | null
필수

속성

object[]
필수

속성

string
필수
투표 내 옵션 식별자입니다.
string
필수
integer
필수
boolean
필수
본인이 이 옵션에 투표했는지 여부입니다.
object[]
필수

속성

string
필수
사용 가능한 옵션: like, view, emoji
boolean
필수
본인이 이 값으로 반응했는지 여부입니다.
integer
필수
integer
필수
string | null
필수
이모지 반응의 경우 유니코드 이모지입니다. 다른 반응 종류의 경우 반응의 값입니다.
object | null
답글 대상 메시지입니다. include_replying_to_message=true가 아니면 생략됩니다. replying_to_message를 제외한 모든 메시지 필드를 포함합니다. 이 메시지가 삭제되었거나 같은 채널에 대상이 없는 경우 null입니다.
string | null
필수
string | null
필수
답글 대상 메시지 작성자의 사용자 ID로, 접두사는 user_입니다. 이 채널에 답글이 없거나 둘 중 한 메시지가 삭제된 경우 null입니다.
string
필수
메시지가 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.
integer | null
필수
익스피리언스 조회수입니다. DM 기반 채널의 경우 null입니다.
ChatMessage