Поднять mock-сервер JSON API
Локальный mock API с health, списком, эхо и ошибкой для отладки клиентов.
Что делает скрипт
Скрипт запускает HTTP-сервер на localhost и отдаёт несколько демонстрационных маршрутов: health, пагинированный список, эхо POST и намеренную ошибку. Данные генерируются в памяти, внешние сервисы не нужны. Удобно проверять пагинацию, обработку ошибок и клиентов без реального бэкенда.
- Сервер слушает только localhost и не предназначен для production.
Быстрый старт
python mock_server.py --port 8000
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python mock_server.py --port 8000curl http://127.0.0.1:8000/api/items?page=2&per_page=3
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
mock_server.py
#!/usr/bin/env python3
"""Mock JSON API для локальной отладки."""
from __future__ import annotations
import argparse
import json
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from urllib.parse import parse_qs, urlsplit
ITEMS = [{"id": number, "name": f"item-{number}", "active": number % 2 == 0} for number in range(1, 26)]
class Handler(BaseHTTPRequestHandler):
server_version = "ScriptDockMock/1.0"
def log_message(self, format: str, *args) -> None:
return
def send_json(self, status: int, payload: object) -> None:
body = json.dumps(payload, ensure_ascii=False).encode("utf-8")
self.send_response(status)
self.send_header("Content-Type", "application/json; charset=utf-8")
self.send_header("Content-Length", str(len(body)))
self.send_header("X-Mock-Server", "script-hub")
self.end_headers()
self.wfile.write(body)
def do_GET(self) -> None:
parsed = urlsplit(self.path)
if parsed.path == "/health":
self.send_json(200, {"status": "ok", "service": "mock-api"})
return
if parsed.path == "/api/items":
query = parse_qs(parsed.query)
try:
page = max(1, int(query.get("page", ["1"])[0]))
per_page = min(50, max(1, int(query.get("per_page", ["5"])[0])))
except ValueError:
self.send_json(400, {"error": "page and per_page must be integers"})
return
start = (page - 1) * per_page
chunk = ITEMS[start:start + per_page]
self.send_json(200, {"page": page, "per_page": per_page, "total": len(ITEMS), "items": chunk})
return
if parsed.path == "/api/error":
self.send_json(500, {"error": "demo failure"})
return
self.send_json(404, {"error": "not found", "path": parsed.path})
def do_POST(self) -> None:
parsed = urlsplit(self.path)
length = int(self.headers.get("Content-Length", "0"))
raw = self.rfile.read(min(length, 1_000_000)) if length else b""
if parsed.path == "/api/echo":
try:
payload = json.loads(raw.decode("utf-8")) if raw else None
except (UnicodeDecodeError, json.JSONDecodeError):
self.send_json(400, {"error": "invalid json"})
return
self.send_json(200, {"received": payload, "bytes": len(raw)})
return
self.send_json(404, {"error": "not found", "path": parsed.path})
def main() -> int:
parser = argparse.ArgumentParser(description="Mock JSON API")
parser.add_argument("--host", default="127.0.0.1")
parser.add_argument("--port", type=int, default=8000)
args = parser.parse_args()
server = ThreadingHTTPServer((args.host, args.port), Handler)
print(f"Mock API: http://{args.host}:{args.port}")
print("Маршруты: /health, /api/items, /api/echo, /api/error")
try:
server.serve_forever()
except KeyboardInterrupt:
print("Остановлено")
finally:
server.server_close()
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.