Для ИИ-агентов и интеграций
Открытый API Рыбстока
Каталог, поиск, фасовки, цены, доставка и оформление заказа в JSON. Без авторизации: внешний ИИ может пройти весь путь от поиска товара до заказа.
Базовый URL
https://rybstock.ru/api/v1
Формат
JSON · UTF-8 · RUB
Авторизация
не требуется
Версия
1.0.0
OpenAPI
/api/openapi
Для ИИ
llms.txt
Как оформить заказ
- Получите категории:
GET /api/v1/categories. - Найдите товары:
GET /api/v1/search?q=...илиGET /api/v1/products. - Возьмите
variant_idиз карточкиGET /api/v1/products/{id-или-slug}. - Проверьте доставку:
POST /api/v1/delivery/quote. - Проверьте заказ без записи:
POST /api/v1/orders/validate. - Создайте заказ:
POST /api/v1/orders. - Проверьте статус:
GET /api/v1/orders/{номер}?phone=....
Оплата только при получении: наличными или QR-кодом. Заказ подтверждает менеджер звонком.
Правила и лимиты
- Чтение — 120 запросов в минуту с одного IP.
- Поиск — 60 запросов в минуту.
- Расчёт доставки — 30 запросов в минуту.
- Проверка заказа — 30 запросов в минуту.
- Создание заказа — 5 в час и 20 в сутки с одного IP.
- Повтор создания заказа безопасен с заголовком
Idempotency-Key.
Заказы, созданные через API, помечаются в админке и в письме администратору. Клиенту эта пометка не показывается.
Справочник
Методы API
| Метод | Путь | Что делает |
|---|---|---|
| Сервис | ||
| 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 | Код | Когда |
|---|---|---|
| 400 | bad_request | Некорректный JSON или параметры запроса. |
| 404 | not_found | Товар/категория/заказ не найдены. |
| 409 | idempotency_conflict / idempotency_in_progress | Idempotency-Key уже использован для другого заказа или заказ с этим ключом сейчас создаётся. |
| 413 | payload_too_large | Тело запроса больше 64 КБ. |
| 422 | validation_error | Не хватает полей, товар недоступен, телефон неполный. |
| 429 | rate_limited | Превышен лимит; смотрите Retry-After. |
| 500 | internal_error | Внутренняя ошибка; повторите позже. |
| 503 | service_unavailable | Сервис или БД временно недоступны. |
Swagger UI
Интерактивная документация
В Swagger можно выполнять GET-запросы. POST-методы (расчёт доставки, проверка и создание заказа) показаны как примеры curl — чтобы случайно не создать заказ кликом.
Загружаем Swagger UI… Если блок не появился, откройте OpenAPI JSON.