📄 1. OpenAPI-спецификация (Swagger)

Вот спецификация в формате OpenAPI 3.0.3, описывающая все доступные эндпоинты.

📦 2. Postman-коллекция

Ниже — Postman-коллекция в формате JSON, которую можно импортировать в Postman.

✅ Как использовать

1. OpenAPI (Swagger)

• Сохраните YAML-файл как openapi.yaml.
• Загрузите в:
  • Swagger Editor
  • Redocly
  • Или интегрируйте в документацию проекта.

2. Postman-коллекция

• Откройте Postman.
• Выберите Import → Paste Raw Text.
• Вставьте JSON выше.
• Создайте environment с переменными:
  • base_url: https://your-server.com
  • api_token: ваш API-ключ

🔐 Примечания по безопасности

• Все запросы требуют заголовка:

  Authorization: Bearer abc123xyz
  

• Токены должны быть защищены.
• Рекомендуется использовать HTTPS.