Key Value
설정과 별개인 기기별 영구 JSON 앱 데이터로, 개발자 모드 없이 사용할 수 있습니다. 허용 키는 last_file_path, quick_note_draft, recent_searches, recent_save_dirs, chat_input_text:peer:ID, chat_input_text:channel:ID이며 ID는 비어 있지 않아야 합니다. 값은 같은 기기의 클라이언트가 공유합니다.
현재 Key Value로 저장하는 데이터
keyValue와 setKeyValue가 현재 허용하는 앱 데이터 키입니다. 표는 현재 클라이언트 값 구조이며 서버가 강제하는 JSON 구조는 아닙니다. ID는 비어 있지 않아야 합니다. 값은 영구 저장되고 같은 기기의 클라이언트가 공유하며 설정이 아닙니다. 값이 없으면 null을 반환합니다. value 인수는 null이 아닌 JSON이며 null로 키를 삭제할 수 없습니다. 예제는 데이터 구조이며 실제 저장된 사용자 내용이 아닙니다.
| Key | JSON 값 구조 | 용도 |
|---|---|---|
| last_file_path | { rootPath: string, fullPath: string, selectedPath: string } | 마지막 파일 탐색 위치: 루트, 전체 경로, 선택 경로. |
| quick_note_draft | string | 전송하지 않은 빠른 메모 텍스트. |
| recent_searches | string[] | 최근 검색어를 최신순으로 저장하며 목록 자르기는 클라이언트가 수행합니다. |
| recent_save_dirs | string[] | 최근 선택한 저장 또는 업로드 디렉터리를 최신순으로 저장하며 목록 자르기는 클라이언트가 수행합니다. |
| chat_input_text:peer:ID | string | ID로 식별된 피어에게 보낼 미전송 채팅 텍스트. |
| chat_input_text:channel:ID | string | ID로 식별된 채널에 보낼 미전송 채팅 텍스트. |
타입 정의
type Mutation {
setKeyValue(key: String!, value: JSON!): Boolean!
}
type Query {
keyValue(key: String!): JSON
}
scalar JSON작업
setKeyValue
허용된 Key Value 키의 JSON 앱 데이터를 영구 저장합니다. 인코딩된 값은 65,536바이트를 초과하면 안 됩니다. 변경되면 true, 같으면 false를 반환하며 이 API는 설정을 변경하지 않습니다.
# Save JSON application data up to 65,536 encoded bytes; returns whether the stored value changed.
mutation setKeyValue($key: String!, $value: JSON!) {
setKeyValue(key: $key, value: $value)
}keyValue
허용된 Key Value 키의 JSON 앱 데이터를 읽습니다. 키가 없으면 null을 반환합니다. 이 API는 설정을 읽지 않습니다.
# Read JSON application data by key; returns null when absent and does not read preferences.
query keyValue($key: String!) {
keyValue(key: $key)
}