У OneFill появился публичный REST API. Если каталог удобнее вести не руками и не через Excel, а из своей системы — 1С, складской программы, собственного сайта или скрипта — теперь это можно делать программно. Логика та же, что у Excel-загрузки: массовое создание и обновление карточек по артикулу.
Шаг 1. Получите API-ключ
- Откройте Профиль → Настройки.
- В разделе «API-ключи» введите название (например, «1С») и нажмите «Создать ключ».
- Скопируйте ключ — он показывается только один раз. Храните его в секрете.
- Ненужный ключ можно отозвать там же — доступ по нему сразу прекратится.
Шаг 2. Аутентификация
Передавайте ключ в заголовке запроса:
Authorization: Api-Key of_ВАШ_КЛЮЧ
# либо
X-Api-Key: of_ВАШ_КЛЮЧЧто умеет API
- POST /api/products/bulk-upsert/ — массовое создание и обновление карточек по артикулу;
- GET /api/products/ — список карточек товаров (постранично).
Артикул — это ключ: нет такого артикула — карточка создаётся; есть — обновляются только переданные поля (остальное не трогается). Фото задаются списком ссылок, первая становится главной (до 30). Для создания новой карточки обязательны название, бренд и обе цены.
Пример запроса
curl -X POST https://onefill.ru/api/products/bulk-upsert/ \
-H "Authorization: Api-Key of_ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"products": [
{"article": "ART-001", "name": "Кофемолка", "brand": "Acme",
"price_before": 3990, "price_after": 2990, "quantity": 15,
"photos": ["https://example.com/main.jpg"]},
{"article": "ART-002", "price_after": 1490}
]}'В ответе придёт сводка: сколько создано, сколько обновлено, и список ошибок по строкам, если они были.
Кому это нужно
API пригодится, если товары и остатки у вас живут в учётной системе (1С, МойСклад, собственная база) и вы хотите автоматически прокидывать их в OneFill, а оттуда — на Ozon, Wildberries, Яндекс Маркет и другие площадки. Полная документация со всеми полями и примерами — на странице Справка → API для разработчиков.
👉 Создать ключ: Профиль → Настройки
Войти через Яндекс