Web и API

Поднять mock-сервер JSON API

Локальный mock API с health, списком, эхо и ошибкой для отладки клиентов.

Python Windows macOS Linux Средний
Скачать mock_server.py
Описание

Что делает скрипт

Скрипт запускает HTTP-сервер на localhost и отдаёт несколько демонстрационных маршрутов: health, пагинированный список, эхо POST и намеренную ошибку. Данные генерируются в памяти, внешние сервисы не нужны. Удобно проверять пагинацию, обработку ошибок и клиентов без реального бэкенда.

Перед запуском
  • Сервер слушает только localhost и не предназначен для production.
Запуск

Быстрый старт

python mock_server.py --port 8000

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python mock_server.py --port 8000
  • curl http://127.0.0.1:8000/api/items?page=2&per_page=3
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get web-mock-server
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Web и API

HTTP, API, сайты, заголовки, SSL и проверка веб-сервисов.

Теги