6 consejos para que DISEÑES BIEN tu API REST
HTML-код
- Опубликовано: 30 июл 2024
- Segundo video de esta miniserie sobre REST. Te doy 6 consejos para que tu API REST quede de la mejor manera.
¿Qué es REST? • ¿Qué es REST? | Te lo ...
MIS CURSOS
🧹 Arquitecturas Limpias para Desarrollo de Software: platzi.com/l/manuelzapata
📐 Arquitectura de Software: manuelzapata.co/ars
🔌 Patrones de Diseño: manuelzapata.co/curso-pdd
📦 Programación Profesional con Objetos (Gratis): manuelzapata.co/objetos
🌲 Principios de Diseño SOLID (Gratis): manuelzapata.co/mcp
🙌 Hazte miembro del canal: / @manuelzapata
🌎 Mi sitio web: manuelzapata.co
🎦 Suscríbete al canal: manuelzapata.co/suscribete
📩 Mi lista de correo: manuelzapata.co/lista
#ManuelZapata #APIREST #Consejos 
Наука
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.
Tremendo aporte. Totalmente de acuerdo contigo Andrés. Gracias!
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!
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????
@@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.
@@andresgrisalesgonzalez7704 Muchas gracias por el aporte :D
"Ya quedó" jajaja, buen checklist Manuel, gracias!
jeje Saludos Guillermo!
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
Excelentes recomendaciones, muchas gracias
Gracias, super claro
Excelente presentación! muchas gracias; buen trabajo! muy interesante
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!
Conciso y con los ejemplos mucho mejor, saludos de Perú Manuel.
Sos un genio tus explicaciones son sencillas y fácil de seguir.
Excelente! el video que estaba buscando, gracias Manuel 👌🏾 Sería interesante hablar un poco sobre los posibles patterns a utilizar en una API
Ha pasado tiempo y sigue siendo el mejor contenido para backend
Excelente video, toda esa información es supervaliosa, muchas gracias.
Excelente tu vídeo, muchas gracias por la información.
Excelente contenido ! mil gracias por lo claro, sencillo y buen material que entregas !
Excelente video. Gracias por compartir estas buenas prácticas.
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 !!!
Muy buenos consejos. Gracias.
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
excelente video, recien estoy aprendiendo acerca de este tema y fue muy explicativo y sencillo de entender
Excelente Manuel, muy buen aporte.
Super... que bien...
Excelente video, gracias
Muy interesante contenido, gracias por compartir
Gracias Manuel, me sirvio mucho tus consejos
Excelente video y muy interesante,
Buen video ! y gracias por compartir estos tips, me sirvieron para tenerlo cuenta en el diseño, saludos !
Muy Claro, cositas por arreglar !! Gracias !
De eso se trata. De ir mejorando. Saludos!
Súper bueno!
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!
Muchas gracias por compartir 👏
Con el mayor de los gusto Domini! 💪
Excelente explicación
Muy interesantes los consejos
Me ayudó bastante, excelente.
Que bueno Cliber! De eso se trata.
Muy bien. Gracias
Gracias a ti
Videos super interesantes!!!!
Excelente; estaré al pendiente de tus vídeos.
Gracias Gudiel! 🙌
Muy chévere estos vidos.!!!! Saludos desde Zipaquirá Cundinamarca
Excelente video, muchas gracias.
Con todo gusto Jhon.
Mil gracias por esta información. Estoy iniciando en Servicios Web y con esto me ayudas mucho.
Genial Diego! Me alegra mucho.
Buen vídeo explicativo Manuel, gracias.
Con gusto Mikel!
Excelentes sugerencias. Sigue así, se aprende mucho con vos!!!!
Gracias!
Great video Architect! Thank you.
You’re welcome Nic Lorenzo!
Genial los tips, los voy aplicar al momento de crear mi api, saludos
Gracias Edwin. Saludos!
Excelente explicación, no he visto este contenido en otros canales, muchas gracias otra vez
Con todo gusto Javier!
Justo lo necesitaba, estoy creando mi primera api rest, muchas gracias
Just in time. Saludos Michelle! 🙌
muy buenos tus videos bro
Gracias amigo, fue de mucha ayuda, aclaraste muchas dudas que tenia desde hace mucho
Excelente Fer. Para eso estamos!
Q genial excelente contenido, me ayudará mucho en mis proximas APIs REST!
De eso se trata Darwin. Saludos!
Hermano muchas gracias eres un crack compatriota, tu contenido es muy bueno.
PaulValencia92 gracias 🙌 Aquí seguimos haciéndole!
Precioso vídeo
Gracias Samuel! 😀
Muy buena explicación, apenaa estoy comenzando en el área de la programación.. 👍
Genial Orlando! Así empiezas con el pie derecho.
Hola, información de calidad, estoy investigando sobre la creación de servicios y aprendi bastante.
Buenísimo!
Cree una REST y estoy aplicando los consejos
Excelente, me aclaro algunas cosas que tenia dudas
Que bueno!
Manuel me encantó el vídeo, podés compartir documentación el tipo de recurso de controladores para ahondar en este concepto?.
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
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!
Excelente Jefferson! Se trata de aprender y seguir mejorando 💪
Vaya que bueno saberlo🇲🇽
🙌
Wooa me resolviste todas mis dudas :o gracias! explicas súper bien y sencillo
Muuchas gracias por tus palabras!
gracias ... lo necesitaba !
Con gusto, Paola.
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..
Ese sería un tema interesante. Gracias por la recomendación Adameck!
Estoy empezando a estudiar este tema y me parece excelente los consejos para la implementación de una api rest. Saludos.
Genial Fabian. Saludos!
muy bueno....!!!
🙌
Esta información es oro puro
Gracias!
muchas gracias !
Con gusto, Angel!
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
Gracias, ahi anote varios fallos y posibilidades de mejorar. Sigue asi, son muy buenos tus videos
Esa es la idea de estos videos. Poder tomar ideas para mejorar. Saludos!
Muchas gracias por el contenido, tengo una duda con el tema de los controladores 4:42 apróx. Hay documentación de referencia o se llaman de otra manera? es la primera ves que veo esa definición y buscando en internet solamente encuentro info de los controllers de mvc.
Excelente!
🙌
Buen video
Excelente información
Gracias Alvaro!
muy bueno el video!! algunos de los temas que hablaste me consultaron en una entrevista técnica
En serio??? Vea pues :)
que buen canal hermano
Excelente viejo Manuel.
Viejo Robert!! No sabía que estabas por acá. Saludos!!
excelentes consejos mano... gracias
Con gusto Luis!
Siempre devolver 200 hahaha identificado.
Muchas gracias c:
Excelentes consejos.
🙌
Buen video, si se pudiera uno explicando un webhook y la diferencia con una api
Exelente contenido.
💪
Sin desperdicio!
🙌
Excelente video Manuel! te felicito! Muy bien explicado y en poco tiempo. Se comprenden los conceptos. Me encuentro desarrollando una API con Yii2 Framework que viene con muchas herramientas para ello. Saludos!
Buenísimo Nicolás. Saludos.
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 .
Anotada la recomendación, Enrique. Gracias!
Saludos desde Cuba.
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?
Gracias por la información, ahora sera interesante aplicar estas reglas. Saludos. Podrías subir un video con un ejemplo?
Ya a partir de aquí lo que toca es que apliques las recomendaciones cuando estes haciendo tu API. Saludos Gerardo!
Están muy interesante el contenido. Excelente. Aún no uso el versionado.
Ya habrá oportunidad de aplicarlo. Saludos Maria!
Gracias, Manuel! Este es un video para visitar muchas veces durante la carrera de desarrollador.
¿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.
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.
Super!! Excelentes consejos. Felicidades! Me gustaría que hablaras sobre Graghql en algún vídeo.
Por ahí lo tengo en el radar. Sobre todo para compararlo con REST.
@@ManuelZapata Esto va estar interesante, ya he implementado un par de APIs en graphql y tengo emociones encontradas al respecto.
Excelente video!! Manuel te tengo un pregunta, como deberia ser el endpoint por ejemplo, si se quiere eliminar una lista de recursos? Ej:Recuerso1,Recuerso2,..,Recuerso10. Deberia hacer 10 DELETE /Recurso/Recuerso1 .... DELETE /Recurso/Recuerso10 ó se podria pasar la lista de RecursosID?
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.
El tema de la capa de negocio da para libros enteros. En el canal tengo un par de videos al respecto. Saludos!
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
Jejeje, excelente. Saludos Juan!
Video esencial para aquellos que hacen API’s a mano.
Mil gracias por recomendar el vídeo @Coderos!!
Me gusto mucho el video, quizas seria bueno un video sobre el patron repositorio y gracias por el contenido
Gracias por la sugerencia!
Tienes algún vídeo de programación de API?
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".
Pasa muchísimo eso! Se desaprovecha toda la semántica de REST y HTTP.
Thanks
🙌
hola buen video, podrias hablar de consejos para apis en graphql
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
Genial Valderrama! Hiciste el live? Qué tal les fue?
@@ManuelZapata Todo bien, Al final no ahondamos hasta los temas de seguridad, pero como te comentaba era Buena tenerlas presentes.
gracias por el video, tienes alguno sobre snkow flake schema, cubos OLAP para bases de datoss? seria bueno una serie
Te agradezco la sugerencia, Diego! Desafortunadamente no es mi área.
Muy buen video Manuel.
Respecto al punto 6. Seria esperable que además del 200, se reciba un json con el id del recurso ingresado y recomiendas algo mas? Yo era un abusador del 200 en cuanto a la conexión, pero siempre devolvía un estado en json.... era muy "ok el proceso, error, tal cosa falta o es duplicada", es decir 200, pero la regla de negocio en un json. Esta demasiado mal? Me recomiendas alguna documentacion paraestandarizar mi aplicacion? Soy autodidacta y eso no me falla, pero querria mejorarlo. Saludos y gracias.