La API de plataforma

Sin publicar

El servicio alojado tiene una interfaz HTTP — es con la que hablan las apps — pero no es una API publicada. No hay documento público, ni versión publicada, ni promesa de estabilidad. No la describimos aquí, porque describirla implicaría una promesa de mantenerla tal como se describe.

Y no guarda nada tuyo

Esa es la mitad menor. La mayor es que no hay rutas específicas de usuario en la plataforma en absoluto, y no hay plan de añadir ninguna.

Una ruta que respondiera «¿cuál es el código de María?» necesitaría el secreto que produce el código, lo que significa que el servidor tendría que guardarlo. Desde ese momento la promesa de extremo a extremo deja de ser cierta — no por mal uso, sino por construcción: un servidor que PUEDE leer tus códigos es un servidor cuyo compromiso lee los códigos de todos. El cuidado de nuestra parte no cambia lo que se llevaría un atacante.

Así que ningún secreto de usuario se guarda en ningún servidor que llevamos. La interfaz de la plataforma es trabajo de nivel de sistema, de máquina a máquina, que no toca ningún dato personal, y el titular de una cuenta no tiene acceso a ella en ningún caso.

Lee eso como el consuelo que pretende ser. La ausencia no es una función que no nos ha dado tiempo a hacer. Es la forma de un sistema diseñado para que el peor día de nuestro lado no sea el peor día del tuyo.

Qué usar en su lugar

Ejecuta el compañero de escritorio y habla con su API local. El daemon guarda la sesión y las claves de la cuenta, y llega a la plataforma en tu nombre. Todo lo de esta sección documenta esa superficie.

Este es el único arreglo en el que algo puede responder por tu cuenta: las claves están en tu máquina, así que la respuesta también tiene que ocurrir ahí.

Para un servidor o una cuenta de máquina sin ninguna persona delante de una pantalla, el compañero se ejecuta sin interfaz y se aplican las mismas rutas.

Cuándo cambia esto

Si la API de plataforma se publica, tendrá sus propias páginas aquí, junto a la local, con el mismo mapa de rutas y la misma declaración de lo que está garantizado. Hasta que las veas, trata la interfaz de plataforma como privada.

Lo que no va a cambiar es la parte de arriba: lo que se publique será de nivel de sistema, y seguirá sin tener ningún secreto tuyo.