Una suite de pruebas integral para validar contratos de API, garantizar la compatibilidad con versiones anteriores y detectar cambios disruptivos en microservicios.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install api-contract-tester
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar api-contract-tester usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es API Contract Tester?
El API Contract Tester es una herramienta robusta diseñada para mantener la integridad de la comunicación entre servicios. Al aprovechar los principios de las pruebas de contrato impulsadas por el consumidor, garantiza que tanto los proveedores como los consumidores cumplan con un acuerdo compartido, evitando el temido 'infierno de las dependencias' en los sistemas distribuidos. Como parte clave del ecosistema de Openclaw Skills, cierra la brecha entre el diseño de la API y la realidad del tiempo de ejecución.
Esta skill automatiza la validación de las especificaciones OpenAPI y Swagger, genera suites de pruebas específicas en Python y monitorea los cambios disruptivos en tiempo real. Ya sea que esté gestionando una arquitectura de microservicios compleja o una simple REST API, esta skill proporciona las protecciones necesarias para implementar con confianza y mantener una alta confiabilidad del sistema.
Casos de uso de API Contract Tester
- Validar que un servicio proveedor todavía cumple con las expectativas de sus consumidores antes de un despliegue.
- Detectar cambios disruptivos en las especificaciones OpenAPI durante los pipelines de CI/CD.
- Generar automáticamente pruebas de camino feliz (happy-path) y casos de borde basadas en la documentación de la API existente.
- Mapear las dependencias de los consumidores para identificar endpoints no utilizados para su depreciación.
- Comprobar la compatibilidad con versiones anteriores entre diferentes versiones de una especificación de API en Git.
Cómo funciona API Contract Tester
- Escaneo: La skill busca en el repositorio archivos de contrato de estilo OpenAPI, Swagger o Pact.
- Generación: Analiza estas especificaciones para crear pruebas de contrato funcionales, que cubren caminos felices, requisitos de autenticación y validación de tipos.
- Verificación: Ejecuta solicitudes contra la URL base del proveedor para asegurar que la API en vivo coincida con el Schema definido.
- Comparación: Para el control de versiones, compara la especificación actual con versiones anteriores de Git para marcar eliminaciones o cambios de tipo.
- Informes: Genera un informe de impacto detallado, clasificando los cambios como disruptivos o no disruptivos y proporcionando recomendaciones de migración.
Configuración de API Contract Tester
Para integrar esto en su entorno de Openclaw Skills, asegúrese de tener instaladas las dependencias de validación necesarias:
# Install the OpenAPI validator
pip install openapi-spec-validator
# Install Pact verifier (if using Pact contracts)
npm install -g @pact-foundation/pact-node
# Ensure your environment has access to the provider URL
export PROVIDER_URL="https://api.staging.example.com"
Esquema de datos y taxonomía de API Contract Tester
La skill organiza sus resultados y análisis utilizando la siguiente estructura:
| Objeto de datos | Formato | Descripción |
|---|---|---|
| Contract Tests | .py (pytest) |
Clases de Python generadas para la validación de endpoints. |
| Change Report | Markdown | Una lista categorizada de cambios disruptivos frente a no disruptivos. |
| Compatibility Matrix | Tabla de texto plano | Un mapeo de qué consumidores llaman a endpoints específicos de la API. |
| Specs | .yaml / .json |
Los archivos fuente de verdad OpenAPI o Pact utilizados para la validación. |
Funciones avanzadas de API Contract Tester
- Comparación de múltiples versiones: Extrae automáticamente versiones anteriores de la especificación del historial de Git (HEAD~1 o main) para análisis de regresión.
- Guías de migración automatizadas: Genera pasos de migración accionables para los desarrolladores cuando se detecta un cambio disruptivo.
- Descubrimiento de dependencias: Utiliza el escaneo de código basado en regex en varios lenguajes (JS, TS, Python) para encontrar consumidores de API no documentados.
- Verificación inteligente de tipos: Detecta cambios disruptivos sutiles como patrones de validación endurecidos o valores de enum eliminados.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Cache Strategy Advisor
Un sistema experto integral para analizar patrones de acceso a datos e implementar arquitecturas de caché multicapa.
Canary Deployment Analyzer
Una utilidad inteligente de DevOps para comparar métricas de canary y baseline con el fin de proporcionar recomendaciones de promoción o rollback de despliegues basadas en datos.
Validador de Cargo.toml
Una utilidad especializada para auditar manifiestos Cargo.toml de Rust para garantizar la corrección estructural, la seguridad de las dependencias y la preparación para crates.io.
Astro Project Analyzer
Una herramienta de auditoría integral diseñada para optimizar los proyectos Astro en cuanto a velocidad, mejores prácticas de configuración y visibilidad en los motores de búsqueda.
Text to Video Hunyuan
Text to Video Hunyuan es una potente herramienta de generación de IA que transforma prompts de texto descriptivos en clips de vídeo 1080p de alta calidad en cuestión de minutos.
Codebase Stats
Una herramienta de Python sin dependencias para el análisis profundo de bases de código, que mide la complejidad, la distribución de idiomas e indicadores de deuda técnica.
Presentado*
