메인 콘텐츠로 건너뛰기
GET
Instagram DM 규칙 조회하기

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

경로 매개변수

id
string<uuid>
필수

생성 시 반환된 규칙의 id입니다.

응답

규칙입니다.

저장된 상태 그대로의 규칙입니다. status, type, target.type은 열린 enum입니다 — API로 만들지 않은 규칙은 다른 유형이거나 게시물에 연결되어 있을 수 있으므로, 클라이언트는 생성이 허용하지 않는 값도 처리할 수 있어야 합니다.

id
string<uuid>
필수

규칙의 id입니다.

url
string<uri>
필수

대시보드 편집기에서 이 규칙을 여는 링크입니다.

status
enum<string>
필수

waiting_for_post(다음 게시물 대기 중), active, scheduled(기간 시작 전), expired(기간 종료), paused(일시정지되었거나 일괄 발송 누락 후 중지됨) 중 하나입니다. 읽는 시점에 일정을 기준으로 계산됩니다. 목록 필터에도 같은 값을 사용합니다.

사용 가능한 옵션:
waiting_for_post,
active,
scheduled,
expired,
paused
type
string
필수

API로 만든 규칙은 standard입니다. 다른 값이 나타날 수 있습니다.

target
object
필수

규칙이 적용되는 대상입니다.

keywords
string[]
필수

규칙을 작동시키는 키워드입니다. 댓글에 이 중 하나라도 포함되면(대소문자 구분 없음) 작동합니다. 비어 있으면 모든 댓글에 작동합니다.

commentReply
object
필수

일치하는 댓글 아래에 달리는 공개 답글입니다.

greeting
object
필수

첫 번째 DM으로, 이어가기 버튼 하나가 달린 메시지입니다.

dm
object
필수

댓글 작성자가 받는 메인 DM입니다.

createdAt
string<date-time>
필수

규칙을 만든 시각(RFC 3339, UTC)입니다.

updatedAt
string<date-time>
필수

규칙을 마지막으로 수정한 시각(RFC 3339, UTC)입니다. 규칙의 집계가 바뀔 때도 갱신되므로 "직접 편집한 시각"은 아닙니다.

schedule
object | null

규칙이 작동하는 일정입니다. 운영 기간(startAt / endAt) 또는 일괄 발송 시각(batchSendAt) 중 하나이며, null이면 항상 켜져 있습니다.

locale
string | null

DocuRise 기본 문구의 언어(en 또는 ko)이며, 저장된 값이 없으면 null입니다.

restricted
boolean

Instagram이 현재 이 규칙의 DM 발송을 제한하고 있습니다.

metrics
object

이 규칙의 누적 집계입니다.