Repolode
Enviar
stoplightio

stoplightio/prism

CLI y servidor HTTP que convierten archivos OpenAPI v2/v3 y Postman Collection en API simuladas con validación de solicitudes y un proxy de validación.

Alternativa open source a:Postman

Ver en GitHubSitio web
Estrellas
5,052
Forks
414
Issues abiertos
147
Último commit
hace 10 días

¿Qué es?

Prism es un conjunto de paquetes para simular API y probar contratos. A partir de un documento OpenAPI v2, OpenAPI v3.x o Postman Collection, inicia un servidor HTTP que devuelve respuestas según la especificación, para que los equipos de frontend y de clientes puedan trabajar antes de que exista el backend.

La misma herramienta puede funcionar como proxy de validación delante de una API real. Comprueba el tráfico con respecto a la descripción de la API e informa de las discrepancias entre la implementación y su contrato. También admite la negociación de contenido y la validación de seguridad. Prism se ejecuta desde la línea de comandos con órdenes como `prism mock` y `prism proxy`, y requiere Node.js 18.20.1 o posterior.

Stoplight también ofrece servidores mock alojados a través de su plataforma comercial y Stoplight Studio, que utilizan Prism internamente. La grabación de tráfico para generar un documento OpenAPI y la persistencia de datos mock figuran como funciones previstas, no como funciones disponibles actualmente.

Funciones clave

  • 01Genera un servidor HTTP mock a partir de archivos OpenAPI v2, v3.0, v3.1 o Postman Collection.
  • 02Valida las solicitudes y respuestas con respecto a la especificación de la API.
  • 03Funciona como proxy de validación delante de una API activa para detectar incumplimientos del contrato.
  • 04Admite la negociación de contenido y la validación de seguridad.
  • 05Se ejecuta desde la línea de comandos y puede utilizarse en integración continua.

Casos de uso

  • Permitir que los desarrolladores de frontend trabajen con una API antes de que se implemente su backend.
  • Comprobar durante las pruebas que una API activa siga coincidiendo con su contrato OpenAPI.
  • Ejecutar dependencias de API simuladas en pipelines de CI.
  • Presentar el diseño de una API a las partes interesadas con respuestas de ejemplo realistas.

Inicio rápido

  1. 1

    Instala Prism CLI con npm (requiere Node.js 18.20.1 o posterior)

    npm install -g @stoplight/prism-cli
  2. 2

    Ejecuta un servidor simulado a partir de un documento OpenAPI

    prism mock https://raw.githack.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore-expanded.yaml
  3. 3

    O ejecuta el proxy de validación delante de una API existente

    prism proxy examples/petstore.oas2.yaml https://petstore.swagger.io/v2

Antes de usarlo

  • Requiere Node.js 18.20.1 o posterior; Node 18.x debe ser, como mínimo, la versión 18.16.

Temas

#openapi#api-testing#mock-server#contract-testing#swagger#postman#cli#hacktoberfest#http-proxy#mocking

Preguntas frecuentes

¿Qué es prism?
CLI y servidor HTTP que convierten archivos OpenAPI v2/v3 y Postman Collection en API simuladas con validación de solicitudes y un proxy de validación. Prism es un conjunto de paquetes para simular API y probar contratos. A partir de un documento OpenAPI v2, OpenAPI v3.x o Postman Collection, inicia un servidor HTTP que devuelve respuestas según la especificación, para que los equipos de frontend y de clientes puedan trabajar antes de que exista el backend.
¿prism es gratuito? ¿Qué licencia tiene?
prism es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿prism sigue mantenido?
Mantenimiento activo. El último commit de prism fue el 12 oct 2026.
¿Para qué puedo usar prism?
Permitir que los desarrolladores de frontend trabajen con una API antes de que se implemente su backend. Comprobar durante las pruebas que una API activa siga coincidiendo con su contrato OpenAPI. Ejecutar dependencias de API simuladas en pipelines de CI. Presentar el diseño de una API a las partes interesadas con respuestas de ejemplo realistas.
¿Cómo se instala prism?
Instala Prism CLI con npm (requiere Node.js 18.20.1 o posterior): npm install -g @stoplight/prism-cli Ejecuta un servidor simulado a partir de un documento OpenAPI: prism mock https://raw.githack.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore-expanded.yaml O ejecuta el proxy de validación delante de una API existente: prism proxy examples/petstore.oas2.yaml https://petstore.swagger.io/v2
¿Dónde consigo prism?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/stoplightio/prism

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados