Generado por Canvas IA
Las APIs (Application Programming Interfaces) son esenciales en el desarrollo de software, ya que permiten la comunicación entre aplicaciones y servicios. En este artículo, aprenderás a crear una API básica utilizando ASP.NET Core, un framework potente y flexible para desarrollar servicios web.
Requisitos previos
Antes de comenzar, asegúrate de tener instalado lo siguiente:
- .NET SDK (descargable desde dotnet.microsoft.com)
- Visual Studio o Visual Studio Code
- Postman o cURL para probar la API
1. Creación del proyecto
Abre una terminal y ejecuta el siguiente comando para crear un nuevo proyecto de API en ASP.NET Core:
dotnet new webapi -n MiPrimeraAPI
cd MiPrimeraAPI
Este comando genera una estructura de proyecto con controladores básicos y configuraciones iniciales.
2. Creación de un controlador
En ASP.NET Core, los controladores manejan las solicitudes HTTP. Ve a la carpeta Controllers y crea un archivo llamado UsuariosController.cs con el siguiente código:
using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
[ApiController]
[Route(«api/[controller]»)]
public class UsuariosController : ControllerBase
{
private static readonly List<string> Usuarios = new List<string> { «Juan», «María», «Carlos» };
[HttpGet]
public IEnumerable<string> GetUsuarios()
{
return Usuarios;
}
[HttpPost]
public IActionResult AgregarUsuario([FromBody] string nombre)
{
if (string.IsNullOrWhiteSpace(nombre))
{
return BadRequest(«El nombre no puede estar vacío.»);
}
Usuarios.Add(nombre);
return Ok($»Usuario {nombre} agregado correctamente.»);
}
}
Explicación del código
- [ApiController]: Define el controlador como una API.
- [Route(«api/[controller]»)]: Define la ruta base como api/usuarios.
- GetUsuarios(): Maneja solicitudes GET para devolver la lista de usuarios.
- AgregarUsuario(string nombre): Maneja solicitudes POST para agregar un nuevo usuario.
3. Configuración de la API
En el archivo Program.cs, asegúrate de que el servicio de controladores está habilitado:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.UseRouting();
app.UseAuthorization();
app.MapControllers();
app.Run();
4. Ejecución y prueba de la API
Ejecuta el siguiente comando en la terminal para iniciar la API:
dotnet run
La API se ejecutará en http://localhost:5000 (o el puerto asignado).
Probando con Postman o cURL
Obtener la lista de usuarios
- En Postman, realiza una solicitud GET a http://localhost:5000/api/usuarios.
- En cURL, usa el siguiente comando:
curl -X GET http://localhost:5000/api/usuarios
Agregar un usuario
- En Postman, selecciona POST, establece la URL http://localhost:5000/api/usuarios y en el cuerpo envía un JSON como este:
«Pedro»
- En cURL, usa:
curl -X POST http://localhost:5000/api/usuarios -H «Content-Type: application/json» -d «\»Pedro\»»
Conclusión
Crear una API en ASP.NET Core es más sencillo de lo que parece. Con solo unos pocos pasos, puedes construir un servicio funcional que gestione datos y responda a solicitudes HTTP. Este es el primer paso hacia el desarrollo de aplicaciones más avanzadas y conectadas.
