메인 콘텐츠로 건너뛰기
POST
curl
노트는 맥락 정보일 뿐 결정이 아닙니다. 노트를 추가해도 거래의 status, score, 알림은 절대 변경되지 않습니다. 검토자는 Console의 거래 상세 화면에 있는 노트 영역에서 노트를 확인할 수 있으며, 거래의 activities에는 TRANSACTION_NOTE_ADDED 항목이 추가됩니다. 이 항목은 거래 조회로 확인할 수 있습니다. 노트는 API 키로 생성되므로 작성자 정보가 없습니다. actor_email과 actor_name은 null입니다. 누가 작성했는지 표시해야 한다면 노트 내용에 그 정보를 포함하세요. 전체 타임라인은 거래 노트 목록 조회로 다시 확인할 수 있습니다.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

transaction_id
string<uuid>
필수

Didit 거래 UUID: POST /v3/transactions/ 및 GET /v3/transactions/에서 반환된 uuid입니다. 자체 txn_id는 허용되지 않습니다.

본문

application/json
note
string
필수

일반 텍스트 메모입니다. 앞뒤 공백은 잘라내며 빈 메모는 거부됩니다. 길이 제한은 없습니다.

Minimum string length: 1
mentioned_emails
string<email>[]

멘션할 조직 멤버의 이메일입니다. 각 이메일은 유효한 조직 멤버의 이메일이어야 합니다.

응답

메모가 생성되었습니다.

모니터링되는 거래의 검토 타임라인에 있는 메모 1개입니다.

uuid
string<uuid>
필수

메모 식별자입니다.

note
string
필수

일반 텍스트 메모 본문입니다.

actor_email
string<email> | null
필수

메모를 작성하거나 상태를 변경한 Console 사용자의 이메일입니다. API 키로 생성된 메모 및 Didit이 자동으로 추가한 메모의 경우 null입니다.

actor_name
string | null
필수

콘솔 사용자의 표시 이름(이름이 없는 경우 이메일)입니다. Didit이 자동으로 추가하는 메모에는 Rule Engine으로 표시됩니다. API 키로 생성된 메모의 경우 null입니다.

metadata
object
필수

메모 유형을 구분합니다. API나 콘솔을 통해 작성된 메모에는 mentioned_emails가 포함됩니다. 콘솔에서 변경된 상태에는 previous_status, new_status, reason_code, reason_label과 함께 type: status_change가 포함됩니다. Didit이 추가하는 메모에는 규칙의 add_note 작업에 대한 source: rule_action(rule_uuid 포함), 또는 사용자 작업 인증 세션을 생성하는 중 발생한 문제에 대한 remediation_session이 포함됩니다.

created_at
string<date-time>
필수

메모가 저장된 시점입니다.

마지막 수정일 2026년 11월 7일