Consumir una API REST en Android con Retrofit y Kotlin
Solicitudes HTTP, DTO, manejo de errores y configuración segura de red.
Consultar un servicio JSON de prueba y mostrar sus datos en la UI.
Antes de comenzar
Parte de un proyecto de prueba o de una copia de trabajo de tu aplicación. Revisa versiones, permisos y dependencias en los enlaces oficiales del final: las plataformas Android y los servicios de Google pueden actualizar sus requisitos.
El objetivo de esta guía es aplicar un proceso concreto y comprobar su resultado. Documenta cualquier cambio relevante para poder mantenerlo y, cuando corresponda, medir sus efectos con datos.
Cómo hacerlo
Prepara una API de pruebas HTTPS y…
Prepara una API de pruebas HTTPS y documenta contrato, campos esperados y códigos de error.
Añade Retrofit y un convertidor JSON compatible…
Añade Retrofit y un convertidor JSON compatible con el proyecto; elige versiones estables desde sus fuentes oficiales.
Define data classes para la respuesta y…
Define data classes para la respuesta y una interfaz Retrofit con una función suspend y anotación HTTP.
Construye el cliente con una URL base…
Construye el cliente con una URL base terminada en / y no incrustes tokens secretos en el APK.
Invoca el servicio desde un repositorio con…
Invoca el servicio desde un repositorio con manejo de excepciones y errores HTTP; registra mensajes útiles sin datos privados.
Expón el resultado en un ViewModel y…
Expón el resultado en un ViewModel y comprueba respuesta correcta, 404, timeout y falta de conexión.
interface ApiEjemplo {
@GET("posts")
suspend fun obtenerPosts(): List<PostDto>
}
data class PostDto(val id: Int, val title: String)
// Fragmento: configura Retrofit.Builder() con baseUrl HTTPS,
// converterFactory, permisos de red y una capa de repositorio.Fragmento educativo: adapta las importaciones, clases, dependencias y versiones a tu proyecto. Consulta la documentación oficial antes de integrarlo.
Ejercicio práctico
Consulta un endpoint HTTPS público de prueba y representa elementos en una lista con estados de carga y error.
INTERNET permite hacer peticiones de red, pero nunca debes confiar en que un cliente Android pueda mantener claves secretas.
Cómo verificar el resultado
- Completa los pasos anteriores en un entorno de pruebas antes de distribuir cambios.
- Comprueba que la función, configuración o estrategia responde al objetivo planteado.
- Revisa errores, impacto para usuarios y políticas aplicables a tu caso.
- Conserva la evidencia y anota qué deberás revisar cuando cambien las versiones.
Fuentes oficiales para profundizar
Consulta los requisitos y ejemplos vigentes en estas fuentes antes de publicar una implementación.