Aún no tienes acceso a esta clase

Crea una cuenta y continúa viendo este curso

Curso de Postman 2020

Curso de Postman 2020

Eduardo Álvarez

Eduardo Álvarez

Publicar Documentación

16/17
Recursos

Aportes 31

Preguntas 4

Ordenar por:

¿Quieres ver más aportes, preguntas y respuestas de la comunidad? Crea una cuenta o inicia sesión.

Una buena práctica en el desarrollo de API, es utilizar bibliotecas de documentación como Swagger, APIDOC, etc.

Para documentar una API también pueden utilizar

https://swagger.io/

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

Excelente

PostMan tiene mucho poder realmente antes no me gusta pero veo que si tiene power

v