Перейти к основному содержимому
Войти

API Reference

Добро пожаловать в справочник API эндпоинтов Hotel Management API.

Быстрые ссылки​

Интерактивное тестирование​

Попробуйте API прямо сейчас!

Все методы в этой документации включают интерактивное тестирование:

  1. Перейдите в раздел "API Methods" в боковом меню
  2. Выберите любой метод (например, Hotels → Get Hotels)
  3. Нажмите "Try it out"
  4. Введите ваш API ключ в поле Authorization: Bearer YOUR_TOKEN
  5. Заполните параметры (или используйте примеры)
  6. Нажмите "Execute" и изучите ответ

Никакой регистрации не требуется - используйте ваш существующий API ключ!

Обзор​

Hotel Management API предоставляет более 150 эндпоинтов, организованных в 25+ роутеров для комплексного управления отельным бизнесом. Все эндпоинты доступны по адресу https://stage.arkhyz-club.ru.

Категории API​

Аутентификация​

Эндпоинты для авторизации и управления сессиями пользователей.

  • Регистрация и вход (email/SMS)
  • JWT токены и refresh
  • Управление ролями пользователей

Отели​

Полное управление отелями, номерами и доступностью с интерактивным тестированием.

  • CRUD операции с отелями
  • Управление номерами и типами номеров
  • Календарь доступности и цены
  • Интерактивное тестирование каждого метода

Бронирования​

Система бронирований с календарем и ценообразованием.

  • Создание и управление бронированиями
  • Статусы платежей
  • Отмены и возвраты

Отзывы​

Система отзывов и рейтингов.

  • Создание и модерация отзывов
  • Лайки и просмотры
  • Статистика рейтингов

Система​

Модули, роли, уведомления и системные настройки.

  • Мониторинг здоровья системы
  • Управление пользователями и ролями
  • Системные уведомления

Базовая информация​

ПараметрЗначение
Base URLhttps://stage.arkhyz-club.ru
АутентификацияJWT Bearer токены
Формат данныхJSON
Rate Limit1000 запросов/час
Версия APIv0.2.5

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

  1. Получите токен доступа:

    curl -X POST https://stage.arkhyz-club.ru/auth/login \
      -H "Content-Type: application/json" \
      -d '{"identifier": "your@email.com", "password": "password"}'

  2. Используйте токен в запросах:

    curl -H "Authorization: Bearer YOUR_TOKEN" \
      https://stage.arkhyz-club.ru/auth/me

  3. Исследуйте эндпоинты: Используйте навигацию слева или страницу статуса API для мониторинга.

Примеры кода​

JavaScript (Fetch API)​

// Авторизация
const response = await fetch('https://stage.arkhyz-club.ru/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ 
    identifier: 'user@example.com', 
    password: 'password' 
  })
});
const { access_token } = await response.json();

// Использование токена
const hotels = await fetch('https://stage.arkhyz-club.ru/hotels/', {
  headers: { 'Authorization': `Bearer ${access_token}` }
});

Python (requests)​

import requests

# Авторизация
auth_response = requests.post('https://stage.arkhyz-club.ru/auth/login', 
    json={'identifier': 'user@example.com', 'password': 'password'})
token = auth_response.json()['access_token']

# Использование токена
headers = {'Authorization': f'Bearer {token}'}
hotels = requests.get('https://stage.arkhyz-club.ru/hotels/', headers=headers)

PHP (cURL)​

// Авторизация
$ch = curl_init('https://stage.arkhyz-club.ru/auth/login');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'identifier' => 'user@example.com',
    'password' => 'password'
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = json_decode(curl_exec($ch), true);
$token = $response['access_token'];

// Использование токена
curl_setopt($ch, CURLOPT_URL, 'https://stage.arkhyz-club.ru/hotels/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $token"]);

Отладка и тестирование​

  • Проверка статуса API - Мониторинг работоспособности в реальном времени
  • Интерактивное тестирование - Каждый эндпоинт содержит "Try It Out" функционал с формами
  • Примеры ответов - Реальные структуры данных с описаниями
  • Авто-заполнение параметров - Готовые примеры для быстрого тестирования

Поддержка​

Если у вас возникли вопросы: