용어 사전

앙크 앱(ANKK APP)의 공식 문서 및 API에서 사용하는 핵심 도메인 용어의 정의와 관련 문서 링크입니다.

🏢 Brand (브랜드)

SNS 연결, 발행 콘텐츠, 팀 멤버, Public API 키가 격리되어 귀속되는 최상위 운영 단위입니다. 각 API 키는 단 하나의 브랜드에 귀속됩니다.

브랜드와 외부 SNS 계정(Instagram, Threads, Bluesky 등) 간의 OAuth/자격증명 연동 리소스입니다. 고유 식별자 connection_id로 참조됩니다.

특정 SNS 연결 계정을 대상으로 하는 논리적 게시물 객체입니다. 본문 텍스트, 미디어, 해시태그, 예약 시각 및 플랫폼별 전용 설정을 포함합니다.

콘텐츠를 실제 대상 SNS에 게시하기 위해 백그라운드 큐에서 실행되는 비동기 작업 단위입니다.

Created Content (생성 콘텐츠): 앙크 Web UI 또는 Public API로 발행을 요청한 콘텐츠로, 예약 수정/취소 및 실패 시 재시도가 가능합니다.
Collected Content (수집 콘텐츠): 앙크 외부에서 이미 게시되어 동기화로 가져온 기존 게시물입니다. 앙크에서 수정/재시도할 수 없습니다.
관련 가이드: 발행된 콘텐츠

인증, 할당량, 입력 유효성 검증을 통과하여 비동기 작업 큐에 등록되었음을 의미합니다. 실제 SNS 게시 완료(published)와는 구분됩니다.

네트워크 타임아웃이나 재시도 시 동일한 쓰기 작업이 대상 SNS에 중복 게시되는 것을 방지하기 위해 클라이언트가 생성하는 고유 키입니다.

Reconnect Required (재연결 필요): 액세스 토큰 만료나 비밀번호 변경 등으로 연결이 끊어져 OAuth 재인증이 필요한 상태입니다.
Requires User Action (사용자 작업 필요): 외부 SNS 앱 내에서 추가 조치(예: 이용약관 동의, 2단계 인증 등)가 필요한 상태입니다.
관련 가이드: 실패와 재시도, SNS 연결하기

게시 성공/실패, 답글 완료 등의 비동기 이벤트가 완료되었을 때 고객 서버로 전달되는 HMAC SHA256 서명된 실시간 HTTP POST 알림입니다.