Referencia de la API

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.

KeyEstructura del valor JSONUso
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_draftstringTexto de nota rápida sin enviar.
recent_searchesstring[]Términos de búsqueda recientes, primero los más nuevos; el cliente recorta la lista.
recent_save_dirsstring[]Directorios de guardado o carga seleccionados recientemente, primero los más nuevos; el cliente recorta la lista.
chat_input_text:peer:IDstringTexto de chat sin enviar para el par identificado por ID.
chat_input_text:channel:IDstringTexto de chat sin enviar para el canal identificado por ID.

Definiciones de tipos

graphql
type Mutation {
  setKeyValue(key: String!, value: JSON!): Boolean!
}

type Query {
  keyValue(key: String!): JSON
}

scalar JSON

Operaciones

mutation

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.

graphql
# 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)
}
query

keyValue

Consultar datos JSON de la aplicación para una clave Key Value permitida. Las claves inexistentes devuelven null. Esta API no lee preferencias.

graphql
# Read JSON application data by key; returns null when absent and does not read preferences.
query keyValue($key: String!) {
  keyValue(key: $key)
}