Una buena práctica en el desarrollo de API, es utilizar bibliotecas de documentación como Swagger, APIDOC, etc.
Introducción y repaso de API
Qué aprenderás sobre Postman
Estudiando el protocolo HTTP, verbos y status
Estructuras de las URLs
Postman
Instalación de Postman
Cómo ejecutar la API
Llamados a un API con GET: llamado de listas y detalles de objetos
Llamados a un API con GET: parámetros en la URL
Llamados a un API con el método post utilizando JSON
Llamados a un API con el método post utilizando Form Data
Llamados a un API con el método PUT
Llamados a un API con el método DELETE
Optimización de environment de postman y configuración de la colección
Agregar ejemplos de responses y descripción de endpoints
Automatización de procesos con JavaScript
Guardar el token del login con una prueba automática
Creación de Pruebas para endpoints
Puesta en producción
Publicar Documentación
Cierre del curso
Aún no tienes acceso a esta clase
Crea una cuenta y continúa viendo este curso
Crear cuenta
Si ya tienes una cuenta,
Iniciar sesión
Publicar Documentación
16/17Recursos
Aportes 31
Preguntas 4
Ordenar por:
Para documentar una API también pueden utilizar
La interfaz que genera es muy buena
Hola!!!
Les comparto un package de npm con el cual pueden convertir la documentación que genera postman en un archivo markdown postman-to-markdown
Esto de la documentación de un API con Postman -> 🤯🤯🤪
POSTMAN NOS PERMITE EXPORTAR COLECCIONES Y ASI ESTO SEA MANEJADA Y PORTABLE
Postman permite trabajo colectivo, en la opción Team, es muy utilizado por desarrolladores de trabajo remoto. Es muy útil, a mi criterio debería estar como un punto principal del curso.
Otra ventaja de tener colecciones es que estas se guardan en el cloud de postman con tu cuenta y de esta manera la puedes usar desde cualquier equipo al abrir postman con tu usuario. De igual manera, la puedes exportar y compartir con tu equipo de trabajo o viceverza.
Que opinan de Insomnia (https://insomnia.rest/) como alternativa ligera de Postman?
¿Esto en serio? Me acabo de enamorar de Postman jaja, esta cosa te crea una documentación completa en una página web cual API profesional!!
Mis apuntes teóricos del curso
Que buena clase, con esto será más facil crear la documentacion de las API y super facil publicarlas!
Actualmente Postman tiene facilidades para Graphql?
Les comparto el link de la API
Link de la documentación
Que loco el nivel de esa documentacion 😵👌
¿El link de la documentación es público?
Para los que están utilizando postman versión 9 en adelante, para publicar los documentos deben seleccionar en los …,
View Documentation.
Verán en la pantalla superior una opción de Publish, para más información.
https://learning.postman.com/docs/publishing-your-api/publishing-your-docs/
Al usar OpenApi antes llamado Swagger, crear la documentación desde postman se vuelve innecesario, ya que te genera la mayor parte de la documentación y es sumamente customizable.
Excelente Curso…
Para cambiar el lenguaje en la versión actual de Postman las opciones están en el menú:
Excelente clase, postman de verdad tiene muchas cosas interesantes!
Documentar es una de las cosas mas importantes a la hora de utilizar una API
Interesante Postman
Para documentar una API yo recomiendo Swagger
¿Alguna forma correcta de almacenar los valores de la URL que la API entiende como parámetros?
http://localhost:8000/api/comments/**:id**
Se vería super completa una documentación así
Esta opción de Postman es muy util, ya que nos permite generar la documentación del proyecto que estamos haciendo de una forma muy profesional y fácil de entender
Qué herramienta tan poderosa
![Francisco Garcia [C6]](https://static.platzi.com/media/avatars/avatars/garciafran_c845c2fe-2ea4-42db-a305-a7f4ef13b0fd.jpeg)
Excelente
PostMan tiene mucho poder realmente antes no me gusta pero veo que si tiene power
¿Quieres ver más aportes, preguntas y respuestas de la comunidad? Crea una cuenta o inicia sesión.