ASP.NET CORE에서 API를 쉽게 생성하세요 🔥

¡ 안녕, 신사! este es mi primer 블로그 en la plataforma, espero les sea de utilidad este artículo ⭐

Vamos a suponer que estamos en la necesidad de crear una API y tiene que ser en ASP.NET Core ¿Qué debemos hacer? 🤔

Primero, para trabajar con plataforma de .NET necesitas tener instalado alguno de sus SDK y su each runtime, te recomiendo que sean los más recientes, haz click aquí para ver los SDK 👈

Este SDK viene con un CLI(Command Line Interface) la cual nos permite crear y ejecutar nuestro proyecto ¡Entré otras muchas coas!

Bien, ahora podemos crear un proyecto desde nuestra terminal con el siguiente comando

dotnet new webapi -n "YourProjectName"

Este comando es especifico para crear una API, pero puedes ver todas las opciones de proyectos distintos disponibles con el comando:

dotnet new --list

Después de dar ese dato, vamos a ver que el comando que previamente ejecutamos nos creo un directorio con el nombre especificado:



Ahora puedes elegir el editor de código de tu preferencia 😊
Visual Studio Code를 활용하여 최신 편집기를 사용하여 다음과 같은 작업을 수행할 수 있습니다.



Como podemos observar nos creó un conjunto de archivos directamente listos para ser ejecutados 🔥

Para probar que todo va bien, (dentro del directorio del proyecto) ejecuta en la terminal el siguiente comando:

dotnet watch run

Ahora ya que tienemos un proyecto listo para t
당신이 할 수 있는 일이 무엇인지 알려주세요.



Este es Swagger, y es solo una interfaz gráfica que nos ayudará a probar nuestra API, viene por defto al crear un proyecto webapi. 👌

Puedes observar que ya tiene un endpoint, pues la plantilla viene con uno por defector, y desde Swagger puedes probar su funcionamiento, despliega el panel, haz click en Try y ejecuta. ❤️

⭐ Ahora ya que tenemos todo listo para trabajar, te mostraré a crear tu controlador, para consecuente, ¡Crear tus endpoints! ⭐

Debes crear un archivo .cs en la carpeta Controllers, este será un controlador y debe seguir la siguiente nomenclatura por convención: NameController.
Por ejemplo, si quiero un controlador para mis empleados, crearé el controlador EmpleadoController 👻

Dentro del archivo crea una clase con el mismo nombre y extienda a la clase ControllerBase, como el siguiente ejemplo(No olvides agregar el espacio de nombres de ControllerBase):

using Microsoft.AspNetCore.Mvc;

namespace YourProjectName.Controllers
{
    public class EmpleadoController : ControllerBase
    {

    }
}

A esta clase debemos relacionarla con un par de atributos:

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase

En el segundo atributo, Route, especificamos la manera de acceder a los endpoints, que de normal es el nombre de controlador, accederemos a un endpoint de estas posibles maneras:

Empleado/get
Empleado/post
Empleado/put

Ahora, al asunto Importante, los endpoints serán los métodos de esta clase 😲

probaremos el siguiente método:

[HttpGet("{i}")]
public int Get(int i)
{
   return i + 1;
}

Ahora podemos ejecutar de nuevo la aplicación y veremos que el método aparece en Swagger, de esta forma lo puedes probar desde esa interfaz.

Como puedes ver en el código, es un simple método que recibe un número y retorna el número +1. 🤣

Pero lo importante es que lo enlazamos a un atributo.
Este atributo define el método http para acceder a nuestro método.

Consulta los diferentes métodos http para que te des una idea 🔥

También observa que le pasamos como argumento un string con un
valor entre corchetes, este valor es el que recibiremos mediante Query String. Dentro de ese mismo string puedes especificar como acceder al método. 관찰자 👀

[HttpGet("sumar/{i}")]
public int Get(int i)
{
    return i + 1;
}

API를 생성할 수 있는 강력한 기본 도구를 사용할 수 있습니다. Próximamente exploraré más tema para Complementar cosas más complejas como bases de datos, documentación 등

Ten un excelente día. 🔥👌