Получить список товаров

Назначение

Демонстрационный метод показывает, как будет выглядеть страница API Reference: описание, параметры, пример запроса и типизированный ответ.

Метод, адрес, параметры и ответ являются черновиком интерфейса документации. Отправить такой запрос в сервис пока нельзя.

Параметры запроса

project_id — идентификатор проекта, товары которого нужно получить.

limit — максимальное число элементов на странице. Предварительное значение по умолчанию — 50.

cursor — непрозрачный курсор следующей страницы, полученный из предыдущего ответа.

updated_after — необязательная дата для выборки недавно изменённых товаров.

Ответ

Ответ содержит массив товаров и объект пагинации. Каждая позиция включает стабильный идентификатор, название, артикулы, статус и время последнего изменения.

Возможные ошибки

Запрос может быть отклонён из-за неверного ключа, отсутствия доступа к проекту, некорректных параметров или превышения лимита. Финальные коды будут опубликованы вместе со спецификацией.

curl --request GET \
  "$MARKETHOUSE_API_URL/v1/products?project_id=project_demo&limit=2" \
  --header "Authorization: Bearer $MARKETHOUSE_API_KEY"

{
  "data": [
    {
      "id": "product_01",
      "name": "Футболка базовая",
      "seller_sku": "TSHIRT-001",
      "status": "active",
      "updated_at": "2026-07-10T09:30:00Z"
    },
    {
      "id": "product_02",
      "name": "Худи утеплённое",
      "seller_sku": "HOODIE-004",
      "status": "active",
      "updated_at": "2026-07-10T09:18:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "cursor_example_next",
    "has_more": true
  }
}