6 consejos para que DISEÑES BIEN tu API REST

[@andresgrisalesgonzalez7704]

Me gustó mucho el vídeo y me atreveré a decir unas cosas y quizá a alguien más también le sirva (si algo no te parece, por favor dímelo :) 1. Bajo el método POST siempre deberíamos enviar un cuerpo (Body). 2. En el ejemplo de /users/1234/favorites, para obtener la colección de favortios utilizamos sobre esa uri el método GET, como dijeste, y si es para agregar un nueva nueva canción (en este caso) a la colección de favoritos de ese usuario 1234, simplemente pasamos bajo el método POST en /users/1234/favorites un body que contenga lo necesario para la operación (por lo general sería simplemente un solo atributo que es el id en este caso de la canción), y ya así tenemos lo necesario para buscar el usuario, la canción, y agregar la canción a los favoritos de ese usuario. 3. Cuando nos traemos colecciones, en mi opinión, deberiamos siempre recibir un pageable (y tener uno por defecto), que le diga de que tamaño quiere las paginas, y cual quiere. También documentar siempre la API, con swagger, por ejemplo. Usar Loggers, que quede rastro siempre de lo que pase en nuestra API REST.

[@ManuelZapata]

Tremendo aporte. Totalmente de acuerdo contigo Andrés. Gracias!

[@mexxiano]

Muy bueno! Una consulta: el pageable, por lo que entiendo, estaría relacionado con la paginación de los datos? Y en ese caso, cómo es recomendable pasar esos datos? En el uri o por post? Gracias!

[@neisservilla7239]

pregunta: que pasa si necesito incrementar las views de una cancion por ejemplo cada que la obtengo con un metodo GET, al ser el get solo para leer informacion y no escribir debo crear otro endpoint con metodo POST para incrementar las views o si es valido modificar las views cada que se llama ese metodo GET????

[@andresgrisalesgonzalez7704]

@@neisservilla7239 Hola, busca sobre algo que se llama Event-Driven Architecture. Lanzas un evento, alguien lo escucha, aumentas el numero de visitas. Es de lo más moderno que hay en el momento.

[@neisservilla7239]

@@andresgrisalesgonzalez7704 Muchas gracias por el aporte :D

[@guillermoreyes5495]

"Ya quedó" jajaja, buen checklist Manuel, gracias!

[@ManuelZapata]

jeje Saludos Guillermo!

[@UlfFrostyPaw]

Realmente esto me parece curioso y no entiendo pq no me lo han ensñado en la universidad. Gracias por hacerlo un poco más entendible para un simple mortal como yo

[@javierherediaruiz6076]

Excelentes sugerencias. Sigue así, se aprende mucho con vos!!!!

[@ManuelZapata]

Gracias!

[@diegtria1]

Hola, información de calidad, estoy investigando sobre la creación de servicios y aprendi bastante.

[@ManuelZapata]

Buenísimo!

[@danielpinto5680]

Excelente video y muy interesante,

[@marthiynashi]

Muy interesante contenido, gracias por compartir

[@LuisLopez1099llg]

Siempre devolver 200 hahaha identificado. Muchas gracias c:

[@javiergutierrez6518]

Ha pasado tiempo y sigue siendo el mejor contenido para backend

[@giacomosantana3305]

Excelente, me aclaro algunas cosas que tenia dudas

[@ManuelZapata]

Que bueno!

[@mikelgalardi2678]

Buen vídeo explicativo Manuel, gracias.

[@ManuelZapata]

Con gusto Mikel!

[@carlosvega2055]

Excelente explicación

[@56f5dbc3]

Excelente video, gracias

[@josemanuelmartinellreynald5785]

Saludos desde Cuba.

[@josejairomejiasoto3109]

Super... que bien...

Muy interesantes los consejos

[@RafaelCayamo]

Gracias por tus consejos, me ayuda mucho a mejorar y hacerme mejor profesional, pienso que luego de resolver el problema logico es importante hacer las cosas entendibles para los que usaran nuestras soluciones, me gustaria si puedes hacer algo en cuanto a la documentacion de las apis, gracias nuevamente

[@samuel23300]

Vaya que bueno saberlo🇲🇽

[@ManuelZapata]

🙌

[@jdbaigorria]

Sos un genio tus explicaciones son sencillas y fácil de seguir.

[@laskalegne]

Videos super interesantes!!!!

[@douglasperez3701]

Excelente video, una consulta como se emplea el tema de las auditorías en las api, por ejemplo en una app web normal usaría session para guardar el usuario que ejecuta alguna acción. Pero en una api por concepto que no guarda estado, como haría tal acción. Muchas gracias, éxitos. Un suscriptor más al canal.

[@ManuelZapata]

Bienvenido al canal, Douglas! En un API con seguridad, la solicitud debe venir con un token que identifica al usuario. De ahí puedes extraer la información que necesitas para hacer auditoria.

[@EdgarDextre]

Conciso y con los ejemplos mucho mejor, saludos de Perú Manuel.

[@alfonsoevangelista9356]

Super!! Excelentes consejos. Felicidades! Me gustaría que hablaras sobre Graghql en algún vídeo.

[@ManuelZapata]

Por ahí lo tengo en el radar. Sobre todo para compararlo con REST.

[@xzdasx]

@@ManuelZapata Esto va estar interesante, ya he implementado un par de APIs en graphql y tengo emociones encontradas al respecto.

[@alejandro5lmL]

Me gustó mucho, de hecho varios de esos errores los aprendí cómo mitos en la escuela y aprendí hasta trabajar como desarrollador. ¿Lo más curioso? Veo aún esos errores en los diseños, así que muchas gracias por recordarme todo esto!

[@Tatan-GIR]

Excelente contenido ! mil gracias por lo claro, sencillo y buen material que entregas !

[@luisa.diazpaneque5584]

excelente video, recien estoy aprendiendo acerca de este tema y fue muy explicativo y sencillo de entender

[@clibercastillo5489]

Me ayudó bastante, excelente.

[@ManuelZapata]

Que bueno Cliber! De eso se trata.

[@grafikdesigner4399]

Buen video ! y gracias por compartir estos tips, me sirvieron para tenerlo cuenta en el diseño, saludos !

[@ypgranados]

Que gran video, he cometido muchas de las malas practicas comentadas aca pero me ha ayudado mucho a comprender mejor el concepto de una api REST, saludos!

[@ManuelZapata]

Excelente Jefferson! Se trata de aprender y seguir mejorando 💪

[@fersenmacias2699]

muy buenos tus videos bro

[@codewithdalvin]

Excelente video, toda esa información es supervaliosa, muchas gracias.

[@alvarof.chavez6463]

Excelente información

[@ManuelZapata]

Gracias Alvaro!

[@edwinberrones5570]

Genial los tips, los voy aplicar al momento de crear mi api, saludos

[@ManuelZapata]

Gracias Edwin. Saludos!

[@ack2012]

Manuel. Felicidades por tus contenidos. Tengo una semana que descubrí tu canal y ya me has ayudado un montón. Muchas gracias. Una sugerencia para temas futuros a tratar: podrías armar algun video acerca de Arquitectura basada en servicios VS. Arquitectura basada en eventos? Cómo saber cuándo usar una o la otra? Ventajas/desventajas, etc..

[@ManuelZapata]

Ese sería un tema interesante. Gracias por la recomendación Adameck!

[@michellev7080]

Justo lo necesitaba, estoy creando mi primera api rest, muchas gracias

[@ManuelZapata]

Just in time. Saludos Michelle! 🙌

[@angelbustamante93]

muchas gracias !

[@ManuelZapata]

Con gusto, Angel!

[@SebastianEPH]

Esta información es oro puro

[@ManuelZapata]

Gracias!

[@KEANCORP]

Cree una REST y estoy aplicando los consejos

[@Colmedoherman]

Excelente! el video que estaba buscando, gracias Manuel 👌🏾 Sería interesante hablar un poco sobre los posibles patterns a utilizar en una API

[@nelsonvalverdelatorre5780]

Muy buen aporte, conocí algunos proyectos que siempre iban como respuesta de api como "200" y encapsulan la respuesta con { "estado," "result","meessage"} Y También con las petición dónde solo se envían solo con "POST".

[@ManuelZapata]

Pasa muchísimo eso! Se desaprovecha toda la semántica de REST y HTTP.

[@kinakeyoytech]

he caido en varias mala practicas, buen video

[@ManuelZapata]

Se trata de identificar, aprender y corregir. Saludos Enrique!

[@CarlosDiaz-wh4jb]

Excelente video. Gracias por compartir estas buenas prácticas.

[@javiergutierrez6518]

Excelente explicación, no he visto este contenido en otros canales, muchas gracias otra vez

[@ManuelZapata]

Con todo gusto Javier!

[@josuedev2440]

Tienes algún vídeo de programación de API?

[@MrAndrewRod]

Muchas gracias, excelentes consejos, la verdad jamás me había detenido a pensar en optimizar mi apis de esta forma, sino que meramente me preocupaba por la comunicación de los datos que fuera efectiva y ya. Pero éste video le da una dimensión más organizada para desarrollar un api rest más eficaz y optima. Muchas Gracias !!!

[@peruvianException]

Excelentes consejos.

[@ManuelZapata]

🙌

[@MrOsnayder]

Muy chévere estos vidos.!!!! Saludos desde Zipaquirá Cundinamarca

[@diegoFolk]

Mil gracias por esta información. Estoy iniciando en Servicios Web y con esto me ayudas mucho.

[@ManuelZapata]

Genial Diego! Me alegra mucho.

[@DgarciarDev]

Muy Claro, cositas por arreglar !! Gracias !

[@ManuelZapata]

De eso se trata. De ir mejorando. Saludos!

[@cristianpadilla2069]

que buen canal hermano

[@faangoos]

Estoy empezando a estudiar este tema y me parece excelente los consejos para la implementación de una api rest. Saludos.

[@ManuelZapata]

Genial Fabian. Saludos!

[@kevindaniel1340]

Manuel me encantó el vídeo, podés compartir documentación el tipo de recurso de controladores para ahondar en este concepto?.

[@miguelj.g.9215]

Excelente tu vídeo, muchas gracias por la información.

[@danielposada3290]

Buen video, muy claro y personalmente me gustaría pedirte que hagas un video de como asegurar los apis, por ejemplo en .net

[@NicoILeone]

Me sumo a este pedido pero con php, quizá se puede hacer algo medio global ;) para entender los conceptos. Saludos!

[@ManuelZapata]

No es fácil ya que tenemos una comunidad muy diversa en tecnologías, pero veremos que se hace. Saludos Daniel y Nicolás!

[@NicoILeone]

@@ManuelZapata Bueno es comprensible. Saludos y gracias!

[@apis3445]

La documentación de Microsoft suele explicar bastante bien cómo agregar seguridad a tus servicios

[@nethanzel]

Gracias, ahi anote varios fallos y posibilidades de mejorar. Sigue asi, son muy buenos tus videos

[@ManuelZapata]

Esa es la idea de estos videos. Poder tomar ideas para mejorar. Saludos!

[@jasonfallas3044]

Exelente contenido.

[@ManuelZapata]

💪

[@Algedibarrios]

Sin desperdicio!

[@ManuelZapata]

🙌

[@lvbernal]

Gracias, Manuel! Este es un video para visitar muchas veces durante la carrera de desarrollador.

[@lvbernal]

¿Qué recomiendas para manejar información delicada en un GET? Por ejemplo, un Id de usuario interno que no se incluya en el token del servicio de autenticación.

[@ManuelZapata]

Leo, lo que yo he hecho en el paso son dos cosas (excluyentes) 1. Incluir ese dato delicado como un custom claim en el access token. 2. Incluirlo como un custom header en el HTTP request.

[@IsraelBuitronD]

¿Podrías hablar entre ventajas y desventajas (técnicas) de usar YAML o JSON?, hay plataformas de desarrollo en las que uno es el estándar y sería interesante tener criterios (nuevamente, técnicos) para ayudar a decidir cuando usar uno y cuando usar otro. Gracias, saludos.

[@ManuelZapata]

Ese tema está bueno. Gracias por la sugerencia Israel!

[@thejuan327]

muchas gracias, aprendí a hacerlas al vuelo con ejemplos en el trabajo y no se seguía ninguna buena práctica, reiniciaré mi vida como programador de apis :O

[@ManuelZapata]

Jejeje, excelente. Saludos Juan!

[@Coderos]

Video esencial para aquellos que hacen API’s a mano.

[@ManuelZapata]

Mil gracias por recomendar el vídeo @Coderos!!

[@CesarBerrio]

Excelente presentación! muchas gracias; buen trabajo! muy interesante

[@saufth]

Gracias amigo, fue de mucha ayuda, aclaraste muchas dudas que tenia desde hace mucho

[@ManuelZapata]

Excelente Fer. Para eso estamos!

[@Mathias-cq3zo]

muchas gracias por tu video!! acabo de aprender lo básico de Django REST en un proyecto en la universidad y este video me ha aclarado muchas dudas y, mejor aún, me ha mostrado buenas prácticas para usar en mis proyectos y también por donde seguir aprendiendo sobre API REST. Saludos desde Chile!

[@edwarmoranrosillo3353]

muy bueno....!!!

[@ManuelZapata]

🙌

[@__cpmarcelo]

Buen video, si se pudiera uno explicando un webhook y la diferencia con una api

[@v4ldevrr4m47]

Hola Manuel, porsupuesto que interesantisimo el tema, me fue util para retrasmitir esos consejos en una charla que preparo tambien. Llegue aqui busando info sobre JWT y viendo los metodos de asegurar tu API. Me dispongo ha hacer mi primera API REST como ejercicio personal y compartire en un live de comunidad pronto. Gracias otra vez

[@ManuelZapata]

Genial Valderrama! Hiciste el live? Qué tal les fue?

[@v4ldevrr4m47]

@@ManuelZapata Todo bien, Al final no ahondamos hasta los temas de seguridad, pero como te comentaba era Buena tenerlas presentes.

[@davisayuspupo9132]

Manuel excelente video, seria de mucha utilidad hacer ejemplos prácticos y ver también como implementar la capa de negocio que debe tener y que consejos de buenas practicas tienes para esa capa.

[@ManuelZapata]

El tema de la capa de negocio da para libros enteros. En el canal tengo un par de videos al respecto. Saludos!

[@pw4645]

Gracias Manuel, me sirvio mucho tus consejos

[@jqr0319]

Excelente Manuel, muy buen aporte.

[@DominiCode]

Muchas gracias por compartir 👏

[@ManuelZapata]

Con el mayor de los gusto Domini! 💪

[@borisxd6614]

Me gusto mucho el video, quizas seria bueno un video sobre el patron repositorio y gracias por el contenido

[@ManuelZapata]

Gracias por la sugerencia!

[@hugogher]

muy bueno el video!! algunos de los temas que hablaste me consultaron en una entrevista técnica

[@ManuelZapata]

En serio??? Vea pues :)

[@paulvalencia9243]

Hermano muchas gracias eres un crack compatriota, tu contenido es muy bueno.

[@ManuelZapata]

PaulValencia92 gracias 🙌 Aquí seguimos haciéndole!

[@gudielcobon]

Excelente; estaré al pendiente de tus vídeos.

[@ManuelZapata]

Gracias Gudiel! 🙌

[@luismosquera7585]

Hola, interesante comentario, excelente, una preguna para un metodo get, como puedo colocar varias formas de consultas, es decir, ejemplo buscar user por Id, por el nombre, y por apellido? como se crearia de forma correcta la url para estos metodos?

[@mariaquintero7713]

Están muy interesante el contenido. Excelente. Aún no uso el versionado.

[@ManuelZapata]

Ya habrá oportunidad de aplicarlo. Saludos Maria!

[@iamthefuelte]

hola manuel te saludo desde argentina, muy bueno tus videos, estoy aprendiendo mucho de vos, tenes algun video en el cual haya mas detalles de versionado de apis?abrazo desde argentina

[@alejandrocabrera8132]

Buen video

[@PilarDarce]

Muy buena explicación! Me gustaría que hablaras más a fondo sobre la seguridad de las API's

[@ManuelZapata]

Muy buen tema Pilar. Lo anoto para futuros temas del canal. Gracias.

[@PilarDarce]

@@ManuelZapata muchas gracias! estaré al pendiente!

[@sirwrad]

Q genial excelente contenido, me ayudará mucho en mis proximas APIs REST!

[@ManuelZapata]

De eso se trata Darwin. Saludos!

[@jemc300x]

Hola Manuel, el material del video esta excelente es muy educativo. Seria bueno uno así pero explicando RPC y mostrando las diferencias entre API REST y RPC .

[@ManuelZapata]

Anotada la recomendación, Enrique. Gracias!

[@FernandoZamudioC]

Es bonito usar Get Post Deleite dependiendo del escenario pero mas alla de verse bonito tiene alguna repercusión beneficio o mejor desempeño?

[@programacionjavahash]

Excelente viejo Manuel.

[@ManuelZapata]

Viejo Robert!! No sabía que estabas por acá. Saludos!!

[@nakeishamartinez7459]

Wooa me resolviste todas mis dudas :o gracias! explicas súper bien y sencillo

[@ManuelZapata]

Muuchas gracias por tus palabras!

[@Solidux2]

Gracias, super claro

[@orlandomanuelospinohernand9869]

Muy buena explicación, apenaa estoy comenzando en el área de la programación.. 👍

[@ManuelZapata]

Genial Orlando! Así empiezas con el pie derecho.

[@johncerpa3782]

Muy buenos consejos. Gracias.

[@juandavidcastroperez9662]

Buen video, ¿Cuándo puedes subir un video en el que compares una aplicación web, una api y una api rest full acerca de su arquitectura y estructura?. Gracias

[@56f5dbc3]

Cual puede ser una buena práctica para hacer una consulta con get enviando filtros?. Por ejemplo. Mi backend tiene una gran carta de platos y varias sedes. Como puedo pedir mediante la api los platos del tipo pizza y que estos estén en una sede. En el back la consulta sería algo asi: select * from CARTA where tipo_plato = "pizza" and sede = "COLOMBIA"

[@CLY_-mj5tg]

NINJA me suscribo yaaaa

[@paolagalarza2823]

gracias ... lo necesitaba !

[@ManuelZapata]

Con gusto, Paola.

[@ederjara3749]

Buen video. Podrias hacer un ejemplo con las buenas practicas. Por ejemplo para busquedas se suele utilizar post con un json en el body. Explicar la responsabilidad de cada capa ejemplo controllers, service, repository, entity, DTO, exceptions

[@ManuelZapata]

Esta buena esa idea. La anoté en mi backlog. Muchas gracias bit code!

[@roy_c]

Agregaria utilizar los headers. Son bastante utiles. Yo los utilizo para manipular los en environments. Y agregaria el tema de hateoas.

[@ManuelZapata]

Gracias!

[@alejoreyes5263]

Una pregunta. En un escenario donde se realice búsqueda de "personas" desde diferentes módulos y se procese diferente de acuerdo al modulo. Que acercamiento recomendarías /api/{modulo}/personas /api/personas?from-module={module}

[@ManuelZapata]

Me iría con la primera ruta. Es muchísimo más REST-friendly que la primera.

[@perseph222]

Hola, gracias por la información, te comento que escucho videos en una bocina Bluetooth y se oye hueco el sonido del vídeo, como el sonido cuando estás en un baño, no sé si me explico. Saludos

[@samuel14luis]

Precioso vídeo

[@ManuelZapata]

Gracias Samuel! 😀

[@LuisSanteliz]

excelentes consejos mano... gracias

[@ManuelZapata]

Con gusto Luis!

[@jufran_87]

Excelentes recomendaciones, muchas gracias

[@diegoalzate5473]

Muchísimas gracias!! Si me identifiqué con varios detallitos, jeje. Pero de ahora en adelante a hacer mejor las cosas! Tengo una pregunta: alguna vez relí que en un futuro solo se iban a soportar los verbos POST y GET, esto es cierto?

[@ManuelZapata]

Esa es la idea, Diego! Encontrar oportunidades de mejora. Lo de que iban a eliminar POST y GET no lo he escuchado.