Рыбсток Качество со склада. Стоковые цены. Рыбсток Качество со склада. Стоковые цены.
★ 5,0 на Яндекс Картах Ближайшие доставки: 23 ноя и 24 ноя +7-967-198-10-94 Самовывоз: г. Москва, ул. Привольная, д. 13к1

Для ИИ-агентов и интеграций

Открытый API Рыбстока

Каталог, поиск, фасовки, цены, доставка и оформление заказа в JSON. Без авторизации: внешний ИИ может пройти весь путь от поиска товара до заказа.

Базовый URL https://rybstock.ru/api/v1
Формат JSON · UTF-8 · RUB
Авторизация не требуется
Версия 1.0.0
OpenAPI /api/openapi
Для ИИ llms.txt

Как оформить заказ

  1. Получите категории: GET /api/v1/categories.
  2. Найдите товары: GET /api/v1/search?q=... или GET /api/v1/products.
  3. Возьмите variant_id из карточки GET /api/v1/products/{id-или-slug}.
  4. Проверьте доставку: POST /api/v1/delivery/quote.
  5. Проверьте заказ без записи: POST /api/v1/orders/validate.
  6. Создайте заказ: POST /api/v1/orders.
  7. Проверьте статус: GET /api/v1/orders/{номер}?phone=....

Оплата только при получении: наличными или QR-кодом. Заказ подтверждает менеджер звонком.

Правила и лимиты

  • Чтение — 120 запросов в минуту с одного IP.
  • Поиск — 60 запросов в минуту.
  • Расчёт доставки — 30 запросов в минуту.
  • Проверка заказа — 30 запросов в минуту.
  • Создание заказа — 5 в час и 20 в сутки с одного IP.
  • Повтор создания заказа безопасен с заголовком Idempotency-Key.

Заказы, созданные через API, помечаются в админке и в письме администратору. Клиенту эта пометка не показывается.

Справочник

Методы API

Открыть OpenAPI JSON
Метод Путь Что делает
Сервис
GET /api/v1 Индекс API
GET /api/v1/health Проверка доступности
GET /api/v1/site Контакты, доставка и оплата
Каталог
GET /api/v1/categories Дерево категорий
GET /api/v1/categories/{slug} Категория по slug
GET /api/v1/products Товары с фильтрами
GET /api/v1/products/{idOrSlug} Карточка товара
Поиск
GET /api/v1/search Умный поиск
Вопросы
GET /api/v1/faq Вопросы и ответы
GET /api/v1/faq/{slug} Ответ целиком
Доставка
POST /api/v1/delivery/quote Расчёт доставки
Заказы
POST /api/v1/orders/validate Проверка заказа без записи
POST /api/v1/orders Создать заказ
GET /api/v1/orders/{orderNumber} Статус заказа

Примеры запросов

Поиск

curl -s 'https://rybstock.ru/api/v1/search?q=калмар'

Карточка товара

curl -s 'https://rybstock.ru/api/v1/products/forel-file'

Расчёт доставки

curl -s -X POST 'https://rybstock.ru/api/v1/delivery/quote' \
  -H 'Content-Type: application/json' \
  -d '{"delivery":{"type":"courier","address":"Москва, ул. Привольная, 13к1"},"items":[{"variant_id":12345,"quantity":1}]}'

Проверка заказа без записи

curl -s -X POST 'https://rybstock.ru/api/v1/orders/validate' \
  -H 'Content-Type: application/json' \
  -d '{
    "customer": {
        "name": "Иван",
        "phone": "+7 967 198-10-94",
        "email": "ivan@example.ru"
    },
    "items": [
        {
            "variant_id": 12345,
            "quantity": 1
        }
    ],
    "delivery": {
        "type": "courier",
        "address": "Москва, ул. Привольная, 13к1",
        "lift": false
    },
    "payment_method": "cash",
    "comment": "Позвонить за час до доставки"
}'

Создание заказа

curl -s -X POST 'https://rybstock.ru/api/v1/orders' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: my-order-2026-11-22-1' \
  -H 'X-Client-Name: my-ai-agent' \
  -d '{
    "customer": {
        "name": "Иван",
        "phone": "+7 967 198-10-94",
        "email": "ivan@example.ru"
    },
    "items": [
        {
            "variant_id": 12345,
            "quantity": 1
        }
    ],
    "delivery": {
        "type": "courier",
        "address": "Москва, ул. Привольная, 13к1",
        "lift": false
    },
    "payment_method": "cash",
    "comment": "Позвонить за час до доставки"
}'

Статус заказа

curl -s 'https://rybstock.ru/api/v1/orders/00015376?phone=+79671981094'

В примерах замените variant_id, номер заказа и телефон на реальные. Суммы и скидки всегда пересчитываются на сервере.

Ошибки

HTTPКодКогда
400bad_requestНекорректный JSON или параметры запроса.
404not_foundТовар/категория/заказ не найдены.
409idempotency_conflict / idempotency_in_progressIdempotency-Key уже использован для другого заказа или заказ с этим ключом сейчас создаётся.
413payload_too_largeТело запроса больше 64 КБ.
422validation_errorНе хватает полей, товар недоступен, телефон неполный.
429rate_limitedПревышен лимит; смотрите Retry-After.
500internal_errorВнутренняя ошибка; повторите позже.
503service_unavailableСервис или БД временно недоступны.

Swagger UI

Интерактивная документация

JSON-спецификация

В Swagger можно выполнять GET-запросы. POST-методы (расчёт доставки, проверка и создание заказа) показаны как примеры curl — чтобы случайно не создать заказ кликом.

Загружаем Swagger UI… Если блок не появился, откройте OpenAPI JSON.