REST d'ASP.NET Core

  • 3 minuts

En anar a una pàgina web, el servidor web es comunica amb el navegador mitjançant HTML, CSS i JavaScript. Per exemple, si interactueu amb la pàgina enviant un formulari de registre o seleccionant un botó de compra, el navegador envia la informació al servidor web.

De manera semblant, els servidors web poden comunicar-se mitjançant serveis web amb una àmplia gamma de clients, com ara exploradors, dispositius mòbils i altres servidors web. Els clients d'API es comuniquen amb el servidor mitjançant HTTP, i tots dos intercanvien informació mitjançant un format de dades com JSON o XML. Les API se solen utilitzar en aplicacions de pàgina única (SPA) que fan la major part de la lògica d'interfície d'usuari en un navegador web. La comunicació amb el servidor web es produeix principalment a través de les API web.

REST: un patró comú per compilar API amb HTTP

Transferència d'estat representacional (REST) ​​és un estil arquitectònic per compilar serveis web. Les sol·licituds REST es fan a través d'HTTP. Usen els mateixos verbs HTTP que usen els exploradors web per recuperar pàgines web i enviar dades als servidors. Els verbs són:

  • GET: Recuperar dades del servei web.
  • POST: Crear un nou element de dades al servei web.
  • PUT: Actualitzar un element de dades al servei web.
  • PATCH: Actualitzar un element de dades al servei web descrivint un conjunt d'instruccions sobre com s'ha de modificar l'element. L'aplicació d'exemple d'aquest mòdul no utilitza aquest verb.
  • DELETE: Eliminar un element de dades al servei web.

Les API de servei web que s'adhereixen a REST s'anomenen API de RESTful. Es defineixen a través de:

  • Identificador URI base.
  • Mètodes HTTP, com GET, POST, PUT, PATCHo DELETE.
  • Un tipus de mitjà per a les dades, com ara notació d'objectes JavaScript (JSON) o XML.

Una API sovint ha de proporcionar serveis per a unes quantes coses diferents, encara que relacionades. Per exemple, l'API de pizzes pot gestionar pizzes, clients i comandes. Usem encaminar per assignar URI a divisions lògiques del codi, de manera que les sol·licituds a https://localhost:5000/pizza s'enrutin a PizzaControlleri les sol·licituds a https://localhost:5000/order ho facin a OrderController.

Avantatges de crear API a ASP.NET Core

Amb ASP.NET es poden fer servir el mateix marc i els mateixos patrons per compilar pàgines web i serveis. Podeu reutilitzar classes de models i lògica de validació, i fins i tot servir a pàgines web i serveis en paral·lel en el mateix projecte. Aquest enfocament té avantatges:

  • Serialització simple: ASP.NET diseñado para experiencias web modernas. Los puntos de conexión serializan automáticamente las clases en JSON con el formato correcto de serie. No se necesita ninguna configuración especial. Puede personalizar la serialización para los puntos de conexión con requisitos únicos.

  • Autenticació i autorització: por motivos de seguridad, los puntos de conexión de API tienen compatibilidad integrada con JSON Web Token (JWT) estándares del sector. La autorización basada en directivas ofrece la flexibilidad necesaria para definir reglas de control de acceso eficaces en el código.

  • Enrutament junt amb el codi: ASP.NET permite definir rutas y verbos en línea con el código, mediante atributos. Los datos de la ruta de acceso de la solicitud, la cadena de consulta y el cuerpo de la solicitud se enlazan automáticamente a parámetros de método.

  • HTTPS predeterminat: HTTP es una parte importante de las API web modernas y profesionales. Se basa en el cifrado de un extremo a otro para proporcionar privacidad y ayudar a garantizar que las llamadas API no se intercepten ni se modifiquen entre el cliente y el servidor.

    ASP.NET proporciona compatibilidad con HTTPS de serie. Genera automáticamente un certificado de prueba y lo importa fácilmente para habilitar HTTPS local de modo que puede ejecutar y depurar las aplicaciones de forma segura antes de publicarlas.

Us compartit de codi i coneixements amb aplicacions .NET

Pot usar les seves aptituts i el ecosistema de .NET per compartir la lògica de la API web amb altres aplicacions compilades amb .NET, amb mòbils, web, escriptori i serveis.

Prova d'API web mitjançant .NET HTTP REPL

Al desenvolupament d'un espai web tradicional, normalment el treball es veu i es prova en un explorador web. Les API web accepten i retornen dades en lloc de HTML, pel que un explorador web no es la millor eina de proves d'API web.

Una de les opcions més fàcils per explorar API web i interactuar amb elles es .NET HTTP REPL. REPL significa read-evaluate-print loop. Es una manera senzilla i popular de compilar entorns de línea de comandes interactives. En la unidad següent crearà una API web simple i a interactuar amb ella mitjançant .NET HTTP REPL.

Mòdul completat:

Següent