Iniciadores Rápidos
¿Cómo construir un backend para Xamarin?

30min
Introducción
En este tutorial, aprenderás cómo construir un backend para tus Xamarin aplicaciones móviles utilizando las potentes características de Back4App. 
Nos basaremos en el REST API, GraphQL, y otras opciones de API web en lugar de usar un SDK dedicado. Este enfoque mantiene tu cliente móvil ligero y flexible, permitiéndote conectarte a tus datos a través de simples llamadas HTTP.
Cubrirá la creación de modelos de base de datos, la aplicación de seguridad, el manejo de autenticación y la realización de operaciones con archivos. 
Siguiendo estos pasos, verás cómo construir un backend para xamarin de manera rápida y segura. 
También explorarás la programación de tareas automatizadas e integrando webhooks para extender la funcionalidad de tu Xamarin aplicación, para que puedas concentrarte en codificar tu interfaz de usuario en lugar de lidiar con configuraciones del servidor.
Una vez que hayas completado esta guía, tendrás una plantilla reutilizable para construir aplicaciones móviles que dependen de Back4App para su backend. 
También entenderás cómo aplicar Listas de Control de Acceso (ACLs), escribir Código en la Nube (si es necesario), e incorporar flujos de trabajo avanzados como Consultas en Vivo o Tareas en la Nube en tu solución final.
Requisitos previos
Para aprovechar al máximo este tutorial, asegúrate de tener:
Una cuenta de Back4App
Regístrate gratis aquí.﻿
Un nuevo proyecto de Back4App
Comenzando con Back4app﻿
Entorno de desarrollo de Xamarin (Visual Studio o Visual Studio para Mac)
Documentación de Instalación de Xamarin﻿
Conocimientos básicos de C# y Xamarin (incluyendo cómo hacer solicitudes de API web desde una clase pública en C#).
Con estos requisitos previos listos, estarás preparado para seguir adelante y conectar tu proyecto de Xamarin a Back4App.
Paso 1 – Crear un Nuevo Proyecto en Back4App y Conectar
Crea un proyecto en Back4App en tu panel de control de Back4App. Esta es la base para tu backend.
Nombra tu proyecto (por ejemplo, “Xamarin-Backend-Tutorial”).
Localiza tus Claves de Aplicación yendo a la sección “Seguridad y Claves” de la aplicación. Verás las claves REST, GraphQL u otras que podrías usar al hacer solicitudes desde tu cliente móvil.
Configura tu proyecto de Xamarin para hacer solicitudes HTTP. En lugar de un SDK de Parse, usarás HttpClient, o cualquier biblioteca de red que prefieras, para llamar a los REST o GraphQL de tu aplicación Back4App.
Por ejemplo, puedes almacenar tu ID de Aplicación y Clave de API REST en un lugar seguro o en un archivo de constantes:
C#
public class Back4AppConstants
{
    public const string AppId = "YOUR_APPLICATION_ID";
    public const string RestApiKey = "YOUR_REST_API_KEY";
    public const string ServerUrl = "https://parseapi.back4app.com";
}
public class Back4AppConstants
{
    public const string AppId = "YOUR_APPLICATION_ID";
    public const string RestApiKey = "YOUR_REST_API_KEY";
    public const string ServerUrl = "https://parseapi.back4app.com";
}
﻿
Al llamar a la api web, siempre incluye estas credenciales en los encabezados de tu solicitud. Esto asegura que tus solicitudes se dirijan a la aplicación correcta con la autorización requerida.
Paso 2 – Configurar la Base de Datos
1. Creando un Modelo de Datos
Utiliza el panel de control de Back4App para definir tus clases o déjalas ser creadas dinámicamente en la primera solicitud. Por ejemplo, si deseas una clase Todo, puedes crearla en la sección de Base de Datos o sobre la marcha a través de llamadas a REST API:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
2. Creando un Modelo de Datos Usando el Agente de IA
Back4App proporciona un Agente de IA que puede generar estructuras de clase completas:
Abre el Agente de IA en tu proyecto de Back4App.
Describe tu modelo (por ejemplo, “Por favor, crea una nueva clase llamada ‘Todo’ con campos de título y isCompleted.”).
Confirma para generar el esquema automáticamente.
﻿
3. Lectura y Escritura de Datos (REST)
Dentro de tu Xamarin proyecto, puedes escribir una public class (por ejemplo, RestClient) que maneje todas las solicitudes a Back4App:
C#
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

public class RestClient
{
    private readonly HttpClient _client;

    public RestClient()
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-Parse-Application-Id", Back4AppConstants.AppId);
        _client.DefaultRequestHeaders.Add("X-Parse-REST-API-Key", Back4AppConstants.RestApiKey);
    }

    public async Task CreateTodoAsync(string title, bool isCompleted)
    {
        var newTodo = new { title = title, isCompleted = isCompleted };
        var content = new StringContent(JsonConvert.SerializeObject(newTodo), Encoding.UTF8, "application/json");
        var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/classes/Todo", content);
        // Handle the response
    }

    public async Task<List<Todo>> GetTodosAsync()
    {
        var response = await _client.GetAsync($"{Back4AppConstants.ServerUrl}/classes/Todo");
        var jsonString = await response.Content.ReadAsStringAsync();
        // Parse JSON into a C# model (Todo)
        // Return the result
        // ...
        return new List<Todo>(); // Placeholder
    }
}

public class Todo
{
    public string objectId { get; set; }
    public string title { get; set; }
    public bool isCompleted { get; set; }
}
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

public class RestClient
{
    private readonly HttpClient _client;

    public RestClient()
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-Parse-Application-Id", Back4AppConstants.AppId);
        _client.DefaultRequestHeaders.Add("X-Parse-REST-API-Key", Back4AppConstants.RestApiKey);
    }

    public async Task CreateTodoAsync(string title, bool isCompleted)
    {
        var newTodo = new { title = title, isCompleted = isCompleted };
        var content = new StringContent(JsonConvert.SerializeObject(newTodo), Encoding.UTF8, "application/json");
        var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/classes/Todo", content);
        // Handle the response
    }

    public async Task<List<Todo>> GetTodosAsync()
    {
        var response = await _client.GetAsync($"{Back4AppConstants.ServerUrl}/classes/Todo");
        var jsonString = await response.Content.ReadAsStringAsync();
        // Parse JSON into a C# model (Todo)
        // Return the result
        // ...
        return new List<Todo>(); // Placeholder
    }
}

public class Todo
{
    public string objectId { get; set; }
    public string title { get; set; }
    public bool isCompleted { get; set; }
}
﻿
4. Lectura y Escritura de Datos (GraphQL)
Para consultas de GraphQL, puedes enviar solicitudes al punto final de GraphQL de Back4App:
Bash
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-Master-Key: YOUR_MASTER_KEY" \
  --data '{"query":"mutation { createTodo(input:{fields:{title:\"Wash the car\" isCompleted:false}}){ todo{ objectId title }}}"}' \
  https://parseapi.back4app.com/graphql
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-Master-Key: YOUR_MASTER_KEY" \
  --data '{"query":"mutation { createTodo(input:{fields:{title:\"Wash the car\" isCompleted:false}}){ todo{ objectId title }}}"}' \
  https://parseapi.back4app.com/graphql
﻿
De manera similar, desde Xamarin, podrías POSTear un cuerpo JSON con tu cadena GraphQL a https://parseapi.back4app.com/graphql.
5. Trabajando con Consultas en Vivo (Opcional)
Aunque estés utilizando llamadas a la API web en lugar del SDK de Parse, aún puedes habilitar Consultas en Vivo si deseas actualizaciones de datos en tiempo real. Utilizarías conexiones especializadas (WebSockets) para suscribirte a cambios de clase. Habilitar Consultas en Vivo desde la Configuración del Servidor de tu aplicación en Back4App, luego usa una biblioteca de cliente compatible en Xamarin, si está disponible. Alternativamente, puedes construir tu propia solución WebSocket o depender de encuestas si el soporte en tiempo real es opcional para tu aplicación.
Paso 3 – Aplicando Seguridad con ACLs y CLPs
1. Visión General de ACLs y CLPs
La seguridad de Back4App incluye Permisos a Nivel de Clase (CLPs) y Listas de Control de Acceso (ACLs). Los CLPs definen qué usuarios o roles pueden leer/escribir en toda una clase. Las ACLs añaden seguridad por objeto. Combínalos para asegurarte de que solo los usuarios autorizados puedan manipular tus datos.
2. Configuración de Permisos a Nivel de Clase
Abre la sección de la Base de Datos en Back4App.
Selecciona tu clase (como Todo).
Ve a Permisos a Nivel de Clase para establecer reglas de lectura/escritura. Podrías permitir que solo los usuarios autenticados lean o escriban. Esto asegura que tu cliente móvil debe iniciar sesión antes de leer datos.
Paso 4 – Escribiendo Funciones de Código en la Nube
1. Por qué Código en la Nube
El Código en la Nube te permite ejecutar lógica personalizada del lado del servidor. Puedes crear reglas de negocio, validaciones o disparadores que se ejecutan cuando los datos cambian. Esto reduce el riesgo de manipulación ya que la lógica se ejecuta fuera del cliente móvil.
2. Ejemplo de Función y Disparadores
A continuación se muestra un ejemplo simplificado de una Función en la Nube en el main.js archivo:
JS
Parse.Cloud.define('helloXamarin', async (request) => {
  return 'Hello from Xamarin Cloud Code!';
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Title is required';
  }
});
Parse.Cloud.define('helloXamarin', async (request) => {
  return 'Hello from Xamarin Cloud Code!';
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Title is required';
  }
});
﻿
3. Despliegue
Para desplegar, puedes usar el Back4App CLI o la sección de Código en la Nube en tu panel de control. Una vez desplegado, puedes llamar a tus funciones desde Xamarin a través de REST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://parseapi.back4app.com/functions/helloXamarin
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://parseapi.back4app.com/functions/helloXamarin
﻿
4. Módulos de NPM
Si necesitas bibliotecas adicionales, instálalas a través de npm en la carpeta de tu proyecto de Cloud Code. Después de eso, require las en tu main.js. Este enfoque es útil para llamar a APIs de terceros desde el lado del servidor.
Paso 5 – Configurando la Autenticación
1. Habilitar la Autenticación de Usuarios
En Back4App, la _User clase gestiona las credenciales de los usuarios. En Configuración de la App, puedes habilitar la autenticación de usuarios, la verificación de correo electrónico y la configuración de restablecimiento de contraseña.
2. Registro / Inicio de Sesión de Usuario (REST)
Desde tu proyecto de Xamarin, podrías escribir métodos en C# para manejar el registro y el inicio de sesión:
C#
public async Task SignUpUserAsync(string username, string password, string email)
{
    var user = new 
    { 
        username = username, 
        password = password,
        email = email 
    };

    var content = new StringContent(JsonConvert.SerializeObject(user), Encoding.UTF8, "application/json");
    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/users", content);
    // Parse response
}

public async Task LogInUserAsync(string username, string password)
{
    var loginEndpoint = $"{Back4AppConstants.ServerUrl}/login?username={username}&password={password}";
    var response = await _client.GetAsync(loginEndpoint);
    // Parse response
}
public async Task SignUpUserAsync(string username, string password, string email)
{
    var user = new 
    { 
        username = username, 
        password = password,
        email = email 
    };

    var content = new StringContent(JsonConvert.SerializeObject(user), Encoding.UTF8, "application/json");
    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/users", content);
    // Parse response
}

public async Task LogInUserAsync(string username, string password)
{
    var loginEndpoint = $"{Back4AppConstants.ServerUrl}/login?username={username}&password={password}";
    var response = await _client.GetAsync(loginEndpoint);
    // Parse response
}
﻿
Luego puedes almacenar los tokens de sesión del lado del cliente para futuras solicitudes.
3. Inicio de Sesión Social
Para integrar inicios de sesión sociales (por ejemplo, Google, Facebook), consulta la documentación de Inicio de Sesión Social de Back4App. Cada proveedor tiene su propio flujo de OAuth, que puedes manejar desde tu cliente móvil. Luego, pasa los tokens devueltos a Back4App.
Paso 6 – Manejo del Almacenamiento de Archivos
1. Configuración del Almacenamiento de Archivos
Los archivos se pueden subir enviando una solicitud POST con los datos del archivo en el cuerpo. Por ejemplo, para almacenar una imagen desde tu aplicación Xamarin, lee la imagen en un arreglo de bytes y luego envía:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary "@local-image.png" \
  https://parseapi.back4app.com/files/myImage.png
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary "@local-image.png" \
  https://parseapi.back4app.com/files/myImage.png
﻿
2. Ejemplo de Carga con C#
C#
public async Task<string> UploadFileAsync(byte[] fileData, string fileName)
{
    var fileContent = new ByteArrayContent(fileData);
    fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("image/png");

    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/files/{fileName}", fileContent);
    var jsonResponse = await response.Content.ReadAsStringAsync();
    // Parse the response to get file URL
    return "File URL from response";
}
public async Task<string> UploadFileAsync(byte[] fileData, string fileName)
{
    var fileContent = new ByteArrayContent(fileData);
    fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("image/png");

    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/files/{fileName}", fileContent);
    var jsonResponse = await response.Content.ReadAsStringAsync();
    // Parse the response to get file URL
    return "File URL from response";
}
﻿
3. Consideraciones de Seguridad
Para asegurar las cargas de archivos, ve a tu Configuración del Servidor en Back4App y ajusta los Permisos de Archivos. Por ejemplo, puedes permitir que solo los usuarios autenticados suban.
Paso 7 – Verificación de Correo Electrónico y Restablecimiento de Contraseña
1. Resumen
La verificación de correo electrónico asegura que los usuarios posean el correo con el que se registraron. Los enlaces de restablecimiento de contraseña les permiten recuperar el acceso si olvidan sus contraseñas.
2. Configuración del Panel de Back4App
Habilitar verificación de correo electrónico en Configuración de Correo Electrónico.
Edita la plantilla de restablecimiento de contraseña y establece la dirección “De”.
También puedes personalizar el contenido del correo electrónico para que coincida con tu marca.
3. Implementación
Una vez habilitado, si un usuario se registra con un correo electrónico, recibirá un enlace de verificación. Las llamadas para restablecer la contraseña se realizan a la misma API base con el correo electrónico del usuario para activar un correo de restablecimiento.
Paso 8 – Programación de Tareas con Cloud Jobs
1. Qué Hacen los Cloud Jobs
Los Cloud Jobs te permiten programar tareas rutinarias, como limpiar datos antiguos o enviar correos electrónicos de resumen diario, todo desde la plataforma de Back4App.
2. Ejemplo
JS
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS_AGO = new Date(now - 30 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', THIRTY_DAYS_AGO);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old items.`;
});
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS_AGO = new Date(now - 30 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', THIRTY_DAYS_AGO);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old items.`;
});
﻿
Despliega el Cloud Code, luego programa el trabajo en Configuración de la Aplicación > Configuración del Servidor > Tareas en Segundo Plano.
Paso 9 – Integración de Webhooks
Define un webhook en Back4App navegando a Más > WebHooks y haciendo clic en “Agregar Webhook.”
Proporciona el endpoint, como https://your-service.com/webhook-endpoint.
Elige los triggers, como “Nuevo objeto en la clase Todo.”
﻿
Los webhooks pueden notificar a servicios de terceros, por lo que tu aplicación Xamarin puede permanecer ligera mientras los sistemas externos manejan lógica o notificaciones adicionales.
Paso 10 – Explorando el Panel de Administración de Back4App
La Aplicación de Administración de Back4App es una forma fácil de manejar operaciones CRUD sin escribir consultas. Actívala en App Dashboard > Más > Aplicación de Administración. Crea un usuario administrador, elige un subdominio y accede.
﻿
Esta Aplicación de Administración es ideal para miembros del equipo no técnicos que necesitan gestionar datos pero no deberían tener acceso directo a la base de datos.
Conclusión
Acabas de ver cómo construir un backend para Xamarin usando Back4App APIs. Creaste clases seguras, añadiste CLPs y ACLs, manejaste la autenticación y exploraste la carga de archivos, la programación de tareas y la integración con servicios externos. Este enfoque asegura que tus aplicaciones móviles se mantengan rápidas y flexibles mientras aprovechan el poder de una base de datos alojada y un entorno en la nube.
Próximos Pasos
Expande tu aplicación Xamarin para manejar lógica más compleja, almacenamiento en caché o roles y permisos avanzados.
Profundiza en características avanzadas, como notificaciones push, o integra datos en tiempo real con Consultas en Vivo si necesitas actualizaciones colaborativas.
Visita la documentación oficial de Back4App para guías más profundas sobre seguridad, rendimiento y depuración.
Crea soluciones del mundo real combinando APIs de terceros (pasarelas de pago, análisis, redes sociales) con tu backend de Back4App. Esta combinación puede mejorar la funcionalidad de tu cliente móvil y mantener tu código organizado.
﻿
Actualizado 23 Jan 2025
¿Esta página le fue útil?
¿Cómo construir un backend para PHP?
¿Cómo construir un backend para React Native?