Открытый API Острова
Для разработчиков и внешних агентов: сведения о центре, календарь, действующие условия и предварительный расчёт.
От вопроса до сметы
Агент уточняет у человека даты, состав группы и пожелания, получает тарифы и отправляет параметры на расчёт. Стоимость считает сервер по тем же правилам, что калькулятор сайта.
Чтение и расчёт доступны без регистрации. Сохранение сметы — по просьбе человека; отправка заявки — после отдельного согласия на передачу контактов.
Базовый адрес: ostrov.center/api/public/v1/
С чего начать
- Прочитайте сведения и контакты и действующий каталог.
- Посмотрите примеры планов и точные поля в OpenAPI. Примеры иллюстративные — выберите даты и состав своего пользователя.
- Отправьте POST /quotes. Проверьте полноту расчёта, итог, строки стоимости и предупреждения.
- Если человек попросил сохранить результат, откройте временную сессию POST /sessions и создайте смету POST /estimates.
Что означает результат
Смета — предварительный расчёт, не платёжный чек. Доступность мест и бронь подтверждает центр. Пустой период календаря не означает свободную неделю. Демонстрационные события обозначены отдельно; запись на авторскую программу уточняйте у организатора.
Ссылка на сохранённую смету даёт доступ к этому документу и обычным действиям сайта. Передавайте её только участникам обсуждения. Токен API действует 30 дней; срок человеческой ссылки от него не зависит.
HTTP и MCP
Любой HTTP-клиент может обращаться по OpenAPI. Python-клиент и адаптер MCP по stdio работают с тем же API, без собственной копии тарифной математики.
Скачайте клиентский комплект или откройте исходники и версии на GitHub. Требования и порядок подключения описаны в инструкции клиентского комплекта. Сохранение и отправка заявки требуют явного подтверждения человека. Подтверждение брони и платежи через этот API не выполняются.
