Skip to content
Back to skills

Api Mock Server

ASecurity

Levanta un servidor HTTP mock en 127.0.0.1 desde un contrato OpenAPI, responde los ejemplos declarados y no sale nunca a la red ni toca el backend real.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobashvueapibackend

Works with

  • cli
  • api

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill api-mock-server --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Api Mock Server?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Api Mock Server
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-api-mock-server/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-api-mock-server)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: api-mock-server
description: Levanta un servidor HTTP mock en 127.0.0.1 desde un contrato OpenAPI, responde los ejemplos declarados y no sale nunca a la red ni toca el backend real.
license: MIT
metadata:
  package: api-contract-guard
  version: "1.1.0"
---

# API Mock Server

## Objetivo

Probar el cliente contra el contrato sin desplegar el backend: respuestas de ejemplo, rutas inexistentes con 404 y nada de tráfico externo.

## Instrucciones de ejecución

1. Levanta el mock desde la raíz del repositorio:

```bash
py api-contract-guard/scripts/mock_server.py --spec api.json --port 8080
```

2. Apunta el cliente a `http://127.0.0.1:8080` y prueba los casos del contrato.
3. Para tests, importa `serve(spec)` y usa el puerto efímero que devuelve; cierra con `shutdown()`.

## Comportamiento

| Petición | Respuesta |
|---|---|
| Ruta y método declarados | `200` con el `example` del contrato |
| Ruta declarada sin ejemplo | `200` con `{"mock": ruta, "method": MÉTODO}` |
| Ruta o método no declarados | `404` con el motivo |

## Límites

- Solo sirve `GET` y `POST` y solo escucha en `127.0.0.1`.
- No valida el cuerpo de la petición ni aplica reglas de negocio: es un mock, no un emulador.
- No resuelve `$ref` externos ni genera datos aleatorios: devuelve lo que el contrato declara.

## Gate de salida

- Puerto y contrato usados quedan escritos junto al resultado de la prueba.
- Toda ruta probada que devolvió 404 está declarada como hueco del contrato.
- El mock se ha cerrado y no queda ningún proceso escuchando.

## Handoff

Entrega a `api-code-sync` las rutas que el cliente llamó y el mock no declaraba, y a `api-diff` cualquier ejemplo que ya no case con el contrato.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.