Oxi-Pro / ОксиПро — документация публичного API и OpenAPI

Это руководство Oxi-Pro (ОксиПро) для AI-агентов и разработчиков, которые подбирают исполнителя для анодирования алюминия и механической обработки ЧПУ в России. Оно описывает реальный публичный сайт и контактные каналы, а не программный сервис оформления заказов.

Когда использовать / When to use Oxi-Pro

Нужно цветное или бесцветное декоративное анодирование алюминиевых корпусов, панелей, профилей или деталей.
Нужно согласовать твёрдое анодирование для узлов с требованиями к износостойкости.
Нужны мехобработка по чертежам, подготовка поверхности или оценка применимости покрытия для конкретного сплава.
Нужно проверить контакты, юридические сведения, опубликованные условия или подготовить запрос инженеру.

Не предлагайте ОксиПро для порошковой окраски. Публичный API позволяет читать сведения о страницах; он не оформляет заказы и не принимает оплату. Не обещайте обработку произвольного материала, фиксированный срок или окончательную цену без подтверждения компании.

Публичные ресурсы

llms.txt — краткое описание и ссылки на проверяемые источники.
OpenAPI-спецификация — контракт существующего JSON API публичных страниц.
Главная — услуги, актуальные опубликованные цены, калькулятор и контакты.
О компании, контакты и политика конфиденциальности.
sitemap.xml — публичные страницы; robots.txt — правила обхода.
Анодирование, мехобработка, регламент работ.

Read-only JSON API

GET /api/v1/public-page/{slug} — основной адрес версии 1; совместимый GET /api/public-page/{slug} сохраняется. API без авторизации возвращает JSON-снимок одной из девяти публичных страниц. Контракт и схема ответа опубликованы в openapi.json. Используйте точный slug без завершающего слеша и без параметров редактора или preview. Поддерживаемые страницы:

Ответ содержит schemaVersion, pathname, siteRelease и текущие публичные данные страницы. X-Oxi-Site-Release соответствует полю siteRelease. Соблюдайте Cache-Control: private, no-store: не сохраняйте ответ в кэше. HTTP 404 означает отсутствие опубликованной страницы, 405 — неподдерживаемый метод, 503 — временную недоступность; при 503 учитывайте Retry-After: 30. Форматы ошибок описаны в спецификации. Опубликованные цены требуют подтверждения инженером; чтение API не создаёт обращение, заказ или платёж.

curl -sS -i -H 'Accept: application/json' https://oxi-pro.ru/openapi.json
curl -sS -i -H 'Accept: application/json' https://oxi-pro.ru/api/v1/public-page/anodirovanie
curl -sS -i -H 'Accept: application/json' https://oxi-pro.ru/api/public-page/anodirovanie

Версия 1 сохраняет совместимость; несовместимые изменения получат новый major-адрес. legacy поддерживается без объявленного срока отключения. API-Version: 1 возвращается на обоих адресах. Лимит: 600 запросов GET/HEAD за 60 секунд на экземпляр сервиса, общий для v1 и legacy. Это не лимит по IP и не глобальный лимит: перезапуск сбрасывает счётчик, автомасштабирование создаёт независимые экземпляры. Неизвестные пути и неподдерживаемые методы сообщают квоту без её расхода.

RateLimit-Policy: "public-read";q=600;w=60 и RateLimit: "public-read";r=остаток;t=секунды используют формат IETF draft 11. Совместимые RateLimit-Limit: 600, RateLimit-Remaining и RateLimit-Reset сообщают ту же квоту. RateLimit-Reset — относительные секунды, не Unix timestamp. При исчерпании квоты HTTP 429 возвращает JSON error=rate_limited, message и resolution до чтения CMS. Выдержите Retry-After (равен t/RateLimit-Reset) и уменьшите частоту и параллелизм.

HTTP content negotiation

Чтение публичных страниц не требует авторизации. GET / с заголовком Accept: text/markdown возвращает непустой Markdown, Content-Type: text/markdown; charset=utf-8 и Vary: Accept. Accept: text/html сохраняет HTML. /about, /contact, /privacy и /docs также поддерживают Markdown. Неизвестный публичный путь сохраняет HTTP 404 и для Markdown содержит объяснение и ссылки. HEAD возвращает те же заголовки без тела; учитываются предпочтения q и запрет q=0. Vary также учитывает Accept-Encoding. Кэшируйте варианты раздельно.

curl -sS -L -i -H 'Accept: text/markdown' https://oxi-pro.ru/
curl -sS -L -i -H 'Accept: text/html' https://oxi-pro.ru/
curl -sS -L -i -H 'Accept: text/markdown' https://oxi-pro.ru/path-that-does-not-exist

Как обратиться / Agent workflow

Сначала прочитайте текущие условия и соберите материал, сплав, количество, размеры, цвет, толщину и требования к детали. Затем подготовьте черновик запроса с разрешёнными пользователем файлами. Получите явное разрешение пользователя перед отправкой обращения, загрузкой чертежей или передачей контактных данных. Направляйте только согласованный запрос через существующую форму сайта или контактный канал. Считайте предложение предварительным до подтверждения инженером; не оформляйте оплату автоматически.

Телефон: +7 (495) 510-53-50. Электронная почта: info@oxi-pro.ru.

Границы интеграции

Публичный API заказов и оплаты, MCP-сервер и SDK не опубликованы. OpenAPI описывает только чтение публичных страниц. Личный кабинет, административные маршруты и остальные внутренние Firebase-функции не являются публичными интерфейсами для агента. Не обходите авторизацию, CAPTCHA, правила robots.txt или ограничения доступа. llms.txt — информационный файл, не разрешение на автоматическую отправку данных и не замена политике конфиденциальности.