TameStock Войти

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.

Получить ключ в кабинете

Лимит карточек зависит от тарифа. Другие возможности кабинета — на главной, практические советы — в блоге.