GuíasTutoriales

Crear un conversor de divisas Flutter con una clave API del servidor

Crea un conversor Flutter tipado que cargue una cotización FX con fuente mediante tu propio proxy, muestre estados de carga y error, informe la antigüedad de caché y redondee solo al mostrar.

29 sept 2026 · 8 min de lectura

Una aplicación móvil Flutter es un cliente público y no debe contener una clave bearer de exchangerate.dev. Pon la clave en un pequeño proxy de servidor /api/fx, haz que Flutter solicite {from,to} y conserva juntos el tipo, la fuente, la sesión de mercado y la marca temporal de observación en un modelo tipado.

  • El archivo Dart descargable llama a tu proxy, nunca a la clave API de exchangerate.dev desde la app.
  • El modelo de respuesta valida rate y data_updated_at antes de renderizar.
  • La carga, los errores HTTP/de formato, la fuente, la sesión de mercado y la antigüedad de caché son visibles.
  • La pantalla usa decimales fijos mientras el valor API sin redondear sigue disponible para el código.
  • Los tipos indicativos sirven para estimaciones y visualización; la liquidación corresponde al proveedor de pagos responsable.

Poner la credencial detrás del servidor

Tu ruta del servidor acepta from y to, añade Authorization: Bearer $EXCHANGERATE_API_KEY, llama a /v1/latest/{from}?symbols={to} y devuelve solo los campos que necesita la app. Conserva la clave en el entorno del servidor. La app pasa su URL de proxy con --dart-define=FX_PROXY_BASE_URL=…; nunca recibe la clave ascendente.

proxy contract · response
GET /api/fx?from=USD&to=EUR{"from":"USD","to":"EUR","rate":0.9245,"source":"live","market_session":"open","data_updated_at":"2026-09-29T10:00:00Z"}

Añadir la dependencia HTTP

Crea una app Flutter, añade el paquete actual http a pubspec.yaml y guarda el conversor Flutter completo como lib/main.dart. Ejecútalo con flutter run --dart-define=FX_PROXY_BASE_URL=https://your-app.example/api/fx. Descarga el proxy Node, define EXCHANGERATE_API_KEY en el entorno del servidor y ejecuta node flutter-currency-converter-proxy.mjs con Node 20 o posterior. Escucha en el puerto de loopback 8787 para pruebas locales. Antes de conectar un dispositivo, publícalo mediante tu propio backend HTTPS autenticado con límites de solicitudes; valida monedas e importe, reenvía la clave y devuelve solo los campos tipados necesarios. El archivo usa widgets Material estándar y un modelo FxQuote tipado. La receta oficial de networking de Flutter explica la configuración del paquete y el patrón de solicitudes.

Validar la cotización antes de renderizar

El modelo rechaza un rate ausente, no positivo, no finito o no numérico, y un data_updated_at ausente. Así evita que una página HTML de error, un fallo del proxy o un JSON vacío entren en la pantalla de conversión. El cliente también limita la solicitud a diez segundos y muestra los estados no 2xx.

Dart · typed response shape
class FxQuote {  final String from;  final String to;  final double rate;  final String source;  final String marketSession;  final DateTime dataUpdatedAt;}

Mostrar carga, errores y frescura

La pantalla desactiva el botón mientras se ejecuta la solicitud, muestra un indicador de progreso y conserva un error legible cuando falla el proxy. Tras el éxito muestra el importe, el tipo, la fuente, la sesión de mercado, la hora de observación, la antigüedad de caché de la app (desde que el dispositivo cargó la respuesta) y la antigüedad de observación (desde data_updated_at). El usuario puede ver si observa un dato de un día de mercado en vivo o una referencia diaria.

Redondear para mostrar y conservar el valor

Para las monedas admitidas por el ejemplo, muestra JPY sin decimales y USD, EUR, GBP e IDR con 2; muestra el tipo con 6 decimales para facilitar la lectura. Es redondeo de presentación. Conserva el tipo numérico analizado y usa una estrategia decimal o de punto fijo en un límite contable de producción; no uses un valor de pantalla binario como registro de liquidación.

Las credenciales móviles son públicas

La ofuscación, las constantes de compilación y un repositorio Flutter privado no hacen secreta una clave una vez que se distribuye la app. El límite del proxy es parte del diseño, no una medida opcional.

Probar el recorrido del cliente

Ejecuta la app con una respuesta de proxy de prueba y prueba después un timeout, HTTP 401/429, JSON malformado, tipo ausente y un data_updated_at antiguo. El networking, TLS y despliegue del proxy específicos de Flutter aún necesitan una comprobación en dispositivo o emulador real; este archivo descargable es un ejemplo de cliente ejecutable, no un proxy alojado.

Solo tipos indicativos

Usa el resultado para estimaciones de conversión, visualización y análisis. Un proveedor de pagos o sistema regulado debe obtener y conservar su propia cotización ejecutable y registro de liquidación.

Preguntas

¿Puede Flutter llamar directamente a la API de exchangerate.dev?

Una app pública puede llamar a endpoints de evaluación anónimos, pero no debe incluir una clave de producción. Usa un proxy del servidor para acceder a una cuenta autenticada.

¿Qué significa la antigüedad de caché en este ejemplo?

La antigüedad de caché de la app es el tiempo transcurrido desde que el dispositivo cargó la respuesta. La antigüedad de observación se mide desde data_updated_at. Una respuesta recién obtenida puede contener una observación diaria o de mercado cerrado más antigua; muestra ambas edades.

¿toStringAsFixed cambia el tipo de la API?

No. Solo formatea el texto mostrado. Conserva el valor numérico analizado para la lógica y usa una estrategia decimal adecuada cuando importe la aritmética exacta.

¿Puede este conversor liquidar un pago?

No. El tipo es una referencia indicativa para estimaciones y visualización, no una cotización ejecutable de liquidación.

Sigue leyendo

Empieza con una clave API gratuita

5.000 solicitudes al mes con el plan gratuito. Sin tarjeta de crédito.

Obtén una clave gratuita