API каталога
Читайте каталог и загружайте товары из 1С или со своего сайта. Правила те же, что в кабинете: та же проверка данных, тот же лимит карточек по тарифу.
Ключ
Ключ создаёт владелец кабинета в разделе «API». Ключ показывается один раз — сохраните его. Передавайте его в каждом запросе:
Authorization: Bearer ts_…
На один ключ — не больше 120 запросов в минуту. При превышении приходит ответ 429 с заголовком Retry-After. Неверный или удалённый ключ даёт 401.
Список товаров
GET https://tamestock.ru/api/v1/products?q=чашка&page=1
Ответ: items (id, sku, name, brand, stock, variants — число вариантов, is_active), total, page, page_size. Параметр q ищет по названию и артикулу.
Товар по артикулу
GET https://tamestock.ru/api/v1/products/CUP-001
Ответ: id, sku, name, brand, description и варианты (sku, label, stock, barcodes). Нет такого товара — 404.
Загрузка товаров пачкой
POST https://tamestock.ru/api/v1/products/bulk-upsert
Content-Type: application/json
{
"items": [
{
"sku": "CUP-001",
"name": "Чашка керамическая",
"brand": "Тест",
"description": "Объём 300 мл",
"stock_shared": true,
"variants": [
{ "sku": "CUP-001-W", "label": "Белая", "stock": 40, "barcodes": ["4600000000017"] },
{ "sku": "CUP-001-B", "label": "Чёрная", "stock": 25 }
]
}
]
}
Новый артикул создаёт товар, известный — обновляет. Обязательны sku и name. Не больше 100 товаров за запрос. Варианты, которые вы не передали, остаются как были. Остаток варианта (stock) уходит на площадки так же, как после правки в кабинете.
Каждый товар обрабатывается отдельно: ошибка в одном не мешает остальным. В ответе по каждому товару есть status: created, updated или error (с описанием в errors).
{
"results": [
{ "index": 0, "sku": "CUP-001", "status": "created", "id": 111 }
],
"created": 1,
"updated": 0,
"failed": 0
}
Вебхуки
Вместо того чтобы опрашивать API, подпишите свою программу на события: в разделе «Вебхуки» кабинета добавьте адрес https://…. Мы отправим на него POST с JSON. Доступные события:
order.created— пришёл новый заказ;order.status_changed— заказ сменил статус (previous_status— прежний). Статусы:new,shipped,delivered,cancelled,returned;stock.changed— остаток варианта изменился:variant(id,sku),reason(manual— вы ввели остаток,shipped— заказ отгружен,returned— возврат),change(на сколько штук) иstock(остаток после изменения);review.created— на площадке появился новый отзыв на ваш товар (только свежие, ещё без ответа):reviewс полямиmarketplace,store_id,external_id,rating(1–5),text,product_name,reviewed_at.
{
"event": "order.created",
"created_at": "2026-10-14T12:30:00+03:00",
"data": {
"order": {
"id": 4821,
"store_id": 7,
"marketplace": "ozon",
"external_id": "0123456-0001-1",
"status": "new",
"previous_status": null,
"ordered_at": "2026-10-14T12:29:41+03:00",
"total": 129000,
"items": [
{ "sku": "CUP-001-W", "name": "Чашка керамическая", "quantity": 2, "price": 64500 }
]
}
}
}
Суммы — в копейках. В заголовках каждого запроса: X-TameStock-Event (событие), X-TameStock-Delivery (номер доставки) и X-TameStock-Signature (подпись). Подпись — HMAC-SHA256 от строки «время, точка, тело запроса» с секретом, который показывается один раз при добавлении адреса:
$time = $signature_t; // из заголовка X-TameStock-Signature: t=...
$expected = hash_hmac('sha256', $time . '.' . $rawBody, $secret);
$valid = hash_equals($expected, $signature_v1) // v1=... из того же заголовка
&& abs(time() - (int)$time) < 300; // не принимайте старые запросы
Адрес должен ответить кодом 2xx в течение 10 секунд. Иначе мы повторим вызов: через минуту, 5 минут, полчаса, 2, 6, 12 часов и через сутки, всего до 8 попыток. Один и тот же вызов может прийти дважды — различайте их по X-TameStock-Delivery. Вызываются только публичные адреса по https, редиректы не обрабатываются. Кнопка «Проверить» отправляет событие ping.
Ошибки
401— нет ключа, ключ неверный или удалён.422— запрос составлен неверно (например, нет спискаitemsили в нём больше 100 товаров).429— слишком много запросов.
Сообщения об ошибках на русском, формат ответов — всегда JSON.
Лимит карточек зависит от тарифа. Другие возможности кабинета — на главной, практические советы — в блоге.