Key Value
Datos JSON de la aplicación por dispositivo, separados de las preferencias y disponibles sin modo de desarrollador. Claves permitidas: last_file_path, quick_note_draft, recent_searches, recent_save_dirs, chat_input_text:peer:ID y chat_input_text:channel:ID (ID no vacío). Los clientes del mismo dispositivo comparten los valores.
Datos almacenados actualmente mediante Key Value
Estas son las claves de datos de la aplicación que keyValue y setKeyValue aceptan actualmente. La tabla describe las estructuras de valores actuales del cliente, no estructuras JSON impuestas por el servidor. ID no debe estar vacío. Los valores son persistentes y compartidos por los clientes del mismo dispositivo; no son preferencias. Los valores inexistentes devuelven null. El argumento value es JSON no nulo; no se puede usar null para eliminar una clave. Los ejemplos describen estructuras de datos, no contenido real guardado por usuarios.
| Key | Estructura del valor JSON | Uso |
|---|---|---|
| last_file_path | { rootPath: string, fullPath: string, selectedPath: string } | Última ubicación del explorador de archivos: raíz, ruta completa y ruta seleccionada. |
| quick_note_draft | string | Texto de nota rápida sin enviar. |
| recent_searches | string[] | Términos de búsqueda recientes, primero los más nuevos; el cliente recorta la lista. |
| recent_save_dirs | string[] | Directorios de guardado o carga seleccionados recientemente, primero los más nuevos; el cliente recorta la lista. |
| chat_input_text:peer:ID | string | Texto de chat sin enviar para el par identificado por ID. |
| chat_input_text:channel:ID | string | Texto de chat sin enviar para el canal identificado por ID. |
Definiciones de tipos
type Mutation {
setKeyValue(key: String!, value: JSON!): Boolean!
}
type Query {
keyValue(key: String!): JSON
}
scalar JSONOperaciones
setKeyValue
Persistir datos JSON de la aplicación para una clave Key Value permitida. Los valores codificados no deben superar 65536 bytes. Devuelve true si cambian y false si son idénticos; esta API no modifica preferencias.
# 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
Consultar datos JSON de la aplicación para una clave Key Value permitida. Las claves inexistentes devuelven null. Esta API no lee preferencias.
# Read JSON application data by key; returns null when absent and does not read preferences.
query keyValue($key: String!) {
keyValue(key: $key)
}