For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/mobile/api.md (or send Accept: text/markdown).
API móvil
Cómo la app habla con el servidor — sesiones, alcanzabilidad y payloads.
Guía paso a paso para principiantes
Requisitos: Lea las dos guías para principiantes que aparecen abajo y complete la configuración local de Mobile. Las variables de Expo van en apps/mobile/.env.local; establezca EXPO_PUBLIC_API_URL en un host de backend accesible desde su dispositivo. Una copia solo de Mobile no incluye un backend Web, así que inicie o conecte uno por separado. Una exportación de Expo correcta solo demuestra el bundle JavaScript, no la aceptación en dispositivos o compras.
Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.
1. En apps/mobile/.env.local, configure EXPO_PUBLIC_API_URL en la dirección de backend en ejecución accesible desde su teléfono; no utilice localhost desde un dispositivo físico.
2. Siga la configuración local móvil para iniciar Expo, iniciar sesión y abrir el espacio de trabajo, la configuración y las pantallas de chat.
3. Espere datos autenticados del mismo espacio de trabajo. Si se agota el tiempo de espera de la solicitud, verifique la red del teléfono y la computadora e inicie el backend por separado en un proceso de pago solo móvil.
Para obtener código personalizado, comience con el prompts/README.md proporcionado y copie el mensaje más cercano: prompts/new-app-screen.md para una pantalla de aplicación o prompts/new-landing-page.md para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea AGENTS.md, .ai/PROJECT_CONTEXT.md y los espejos .ai/ correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.
Comprende el alcance nativo
Expo incluye autenticación/sesiones nativas y enlaces profundos junto con superficies de espacios de trabajo, ajustes, chat y compras RevenueCat. El comportamiento compartido y la autorización permanecen en el backend y los paquetes web; los clientes nativos de apps/mobile/src llaman a esas API sin incluir credenciales de proveedores.
Usa el BFF autenticado mediante sesión
Las rutas /api/mobile cubren permisos, disponibilidad y sincronización de compras RevenueCat en el servidor, organizaciones, miembros, invitaciones, auditoría, claves API, webhooks, dominios, horarios y solicitudes de funciones. Mantienen la propiedad del espacio de trabajo y las comprobaciones de rol. Son distintas del contrato público con clave Bearer sk_ /api/v1.
Usa EXPO_PUBLIC_API_URL accesible desde el dispositivo y el origen/esquema configurados; las variables públicas de Expo nunca contienen credenciales de proveedores.
Verifica en destinos nativos
Comprueba los estados de carga/error/vacío, la reconexión, la sesión caducada, las acciones de administración prohibidas y los retornos de enlaces profundos en el dispositivo/compilación que pienses admitir. Una exportación Expo demuestra el empaquetado, no la entrega nativa ni la aceptación de compras.
Configuración y ajustes
La app llama a la API bajo /api/mobile y la superficie versionada /api/v1 con la sesión del miembro en lugar de suposiciones de cookies de la app web. EXPO_PUBLIC_API_URL es el único origen que el cliente conoce; es público por diseño y no lleva secretos.
Los tokens de sesión vienen del flujo Better Auth Expo y se guardan en almacenamiento seguro nativo — nunca en AsyncStorage en claro ni en configuración empaquetada.
GET /api/mobile/entitlement # access state for the member
GET /api/mobile/organization # active workspace context
GET /api/mobile/usage # current-month AI spend, meter caps, and credit balance
GET /api/mobile/appearance # synced appearance bundle (GET/PUT)
POST /api/v1/ai-tasks # authorized work, same as web
Session: /api/auth/* (Better Auth Expo flow)
# Optional server-only token for authenticated Expo push sends:
# EXPO_ACCESS_TOKEN=Flujo de implementación
Resuelve la sesión almacenada antes de la primera petición autenticada, refréscala cuando el servidor reporte expiración y cierra sesión limpiamente cuando sea revocada. Trata API inalcanzable y sesión inválida como estados diferentes — uno reintenta, el otro vuelve al acceso.
Mantén los payloads idénticos al contrato web: el servidor aplica las mismas reglas de workspace, entitlement y validación sin importar qué cliente llamó.
Verificación y solución de problemas
Prueba fallos en modo avión, tokens expirados a mitad de sesión, sesiones revocadas y un arranque en frío con un token válido almacenado. Una petición que falla cerrada (denegada) es correcta; una que falla abierta es un bug a corregir antes del release.