triliumnext-korean-patch/updates/2026-09-05/work/trilium/api-etapi-ko.txt

ETAPI
Trilium 외부 API
노트를 만들고 노트 트리에 배치합니다.
노트 생성 완료
예기치 않은 오류
노트 검색
https://triliumnext.github.io/Docs/Wiki/search.html 에 설명된 형식의 검색어
검색어로 전체 텍스트 검색. 정확히 일치할 필요는 없습니다.
정확히 일치하는 전체 텍스트 검색. 큰따옴표를 사용합니다.
검색어와 라벨 조건을 모두 만족하는 전체 텍스트 검색
빠른 검색 사용. 전체 텍스트 검색에서 본문은 확인하지 않습니다.
기본적으로 보관된 노트는 검색하지 않습니다. true로 설정하면 검색 결과에 포함합니다.
지정한 subtree 노트 ID의 하위 트리만 검색합니다. 기본값은 전체 트리입니다.
검색할 노트의 트리 깊이를 지정합니다.
기준 상위 노트에서 정확히 한 단계 아래인 직계 하위 노트. 기준을 지정하지 않으면 루트입니다.
기준 상위 노트에서 정확히 세 단계 아래. 기준을 지정하지 않으면 루트입니다.
기준 상위 노트에서 네 단계 미만인 깊이 1~3. 기준을 지정하지 않으면 루트입니다.
기준 상위 노트에서 두 단계보다 깊은 위치. 깊이 3부터 해당하며 기준을 지정하지 않으면 루트입니다.
검색 결과 정렬에 사용할 속성 또는 라벨 이름
정렬 방향. 오름차순 또는 내림차순입니다.
반환할 결과 수 제한
true로 설정하면 검색어 구문 분석에 관한 디버깅 정보를 응답에 포함합니다.
검색 응답
ID로 노트를 조회합니다.
노트 응답
noteId로 지정한 노트에 요청 본문의 변경 사항을 적용합니다.
노트 변경 완료
noteId로 지정한 노트 하나를 삭제합니다.
노트 삭제 완료
ID로 노트 본문을 조회합니다.
노트 본문 응답
ID로 지정한 노트의 본문을 변경합니다.
노트의 HTML 본문
노트 본문 변경 완료
지정한 하위 노트 트리를 ZIP 파일로 내보냅니다. 전체 문서를 내보내려면 noteId에 "root"를 사용합니다.
내보낸 ZIP 파일
지정한 노트로 ZIP 파일을 가져옵니다.
지정한 노트의 수정 이력을 만듭니다.
수정 이력 생성 완료
가지를 만들어 같은 노트를 트리의 다른 위치에도 배치합니다. 상위 노트와 하위 노트 사이에 가지가 이미 있으면 기존 가지의 prefix와 notePosition 및 isExpanded를 변경합니다.
기존 가지 변경 완료. 상위 노트와 하위 노트 사이에 가지가 이미 있었습니다.
가지 생성 완료
ID로 가지를 조회합니다.
가지 응답
branchId로 지정한 가지에 요청 본문의 변경 사항을 적용합니다. prefix와 notePosition만 변경할 수 있습니다. 다른 속성을 바꾸려면 기존 가지를 삭제하고 새로 만들어야 합니다.
가지 변경 완료
branchId로 지정한 가지를 삭제합니다. 해당 하위 노트의 마지막 가지라면 노트도 삭제합니다.
가지 삭제 완료
첨부 파일 생성
첨부 파일 생성 완료
ID로 첨부 파일을 조회합니다.
첨부 파일 응답
attachmentId로 지정한 첨부 파일에 요청 본문의 변경 사항을 적용합니다. role과 mime 및 title과 position만 변경할 수 있습니다.
속성 변경 완료
attachmentId로 지정한 첨부 파일을 삭제합니다.
첨부 파일 삭제 완료
ID로 첨부 파일 내용을 조회합니다.
첨부 파일 내용 응답
ID로 지정한 첨부 파일의 내용을 변경합니다.
첨부 파일의 HTML 내용
첨부 파일 내용 변경 완료
지정한 노트에 속성 생성
속성 생성 완료
ID로 속성을 조회합니다.
속성 응답
attributeId로 지정한 속성에 요청 본문의 변경 사항을 적용합니다. 라벨은 value와 position만 변경할 수 있고 관계는 position만 변경할 수 있습니다. 다른 속성을 바꾸려면 기존 속성을 삭제하고 새로 만들어야 합니다.
attributeId로 지정한 속성을 삭제합니다.
속성 삭제 완료
가지의 notePosition은 연결된 클라이언트에 자동으로 전달되지 않습니다. 변경한 순서를 즉시 반영하려면 notePosition을 설정한 뒤 이 기능을 호출하세요. 순서가 바뀐 가지의 parentNoteId를 전달해야 합니다.
연결된 모든 클라이언트에서 노트 순서를 비동기로 갱신합니다.
새 노트를 넣을 수집함 노트를 반환합니다. 날짜 사용 여부는 수집함이 #inbox 라벨로 지정된 고정 노트인지 일지의 날짜별 노트인지에 따라 달라집니다.
수집함 노트
지정한 날짜의 일별 노트를 반환합니다. 없으면 새로 만듭니다.
일별 노트
지정한 날짜의 주별 노트를 반환합니다. 없으면 새로 만듭니다.
주별 노트
월별 노트
연도별 노트
비밀번호로 ETAPI 토큰을 발급받습니다. 이후 ETAPI 호출에 사용합니다.
Trilium 서버 로그인이나 노트 보호에 사용하는 사용자 비밀번호
인증 토큰
짧은 시간에 요청이 너무 많아 클라이언트 IP가 차단됐습니다. 인증 실패가 원인일 수 있습니다. 잠시 후 다시 시도하세요.
ETAPI 토큰을 삭제하거나 비활성화하여 로그아웃합니다.
로그아웃 성공
실행 중인 Trilium 인스턴스 정보를 반환합니다.
앱 정보
예를 들어 backupName이 "now"이면 "backup-now.db" 파일에 백업합니다.
지정한 이름으로 데이터베이스를 백업합니다.
백업 생성 완료
HTTP 기본 인증에서 사용자 이름은 임의의 문자열을 사용하며 검사하지 않습니다. 예: trilium. 비밀번호 자리에는 발급받은 ETAPI 토큰을 넣습니다. Trilium 로그인 비밀번호는 사용할 수 없습니다. 설정의 ETAPI 항목에서 생성한 토큰을 사용하세요.
트리에서 상위 노트의 ID
노트 유형이 code 또는 file 또는 image일 때만 지정하면 됩니다.
상위 노트 안에서의 순서입니다. 일반적인 순서는 10 단위로 증가합니다. 맨 앞에 넣으려면 5를 사용할 수 있고 두 번째는 15를 사용할 수 있습니다. 맨 뒤에 넣으려면 1000000처럼 큰 값을 사용하세요.
prefix는 노트가 배치된 가지마다 따로 붙이는 제목 접두사입니다. 같은 노트를 두 곳에 배치하고 한쪽에서만 제목을 조금 다르게 표시하려면 접두사를 사용하세요.
노트를 폴더처럼 펼쳐 표시하려면 true로 설정합니다.
특정 noteId를 강제로 지정하려는 경우에만 입력하세요.
특정 branchId를 강제로 지정하려는 경우에만 입력하세요.
노트 생성 시각의 현지 타임스탬프입니다. 현재 시간대의 현재 시각이라는 기본값을 바꿀 때만 지정하세요.
노트 생성 시각의 UTC 타임스탬프입니다. 현재 시각이라는 기본값을 바꿀 때만 지정하세요.
본문 해시 역할을 하는 데이터 객체의 ID
가지는 노트를 트리에 배치하며 상위 노트와 하위 노트의 관계를 나타냅니다.
하위 노트 식별자
상위 노트 식별자
첨부 파일은 노트에 속하며 제목과 내용을 가집니다.
첨부 파일 소유자의 식별자. noteId 또는 revisionId입니다.
속성은 노트에 연결된 키와 값의 쌍이며 라벨과 관계로 나뉩니다.
&debug=true로 활성화한 검색어 구문 분석 디버깅 정보
Trilium 버전
데이터베이스 버전
동기화 프로토콜 버전
빌드 날짜
빌드에 사용한 Git 커밋
Trilium 파일을 저장하는 데이터 디렉토리
지원하는 Trilium 웹 클리퍼 프로토콜 버전
현재 UTC 날짜와 시각
HTTP 응답에 사용한 것과 같은 HTTP 상태 코드
고정된 문자열 상수
사람이 읽을 수 있는 오류 설명. 추가 정보가 포함될 수 있습니다.