Товари | Placraftic

Товар — це готовий виріб із каталогу студії, що продається за фіксованою ціною, на відміну від розрахунку вартості, де ціна обчислюється індивідуально під завантажену модель. Використовуйте цей ендпоінт, щоб синхронізувати каталог готових виробів студії із зовнішньою вітриною чи маркетплейсом.

Доступ лише для читання — керуйте товарами через панель студії.

Об'єкт Product#

Поле	Тип	Опис
`id`	integer	Унікальний ідентифікатор товару
`title`	string	Назва товару
`description`	string \| null	Опис товару
`photos`	array	Список фотографій товару, кожна — `{ "url": string, "objectKey": string }`. `url` — тимчасове підписане посилання (дійсне обмежений час), `objectKey` — постійний внутрішній ідентифікатор файлу
`price`	Money	Ціна товару
`leadTime`	integer \| null	Орієнтовний термін виготовлення в днях
`isActive`	boolean	Чи показується товар у каталозі студії
`studioId`	integer	Ідентифікатор студії-власника
`createdAt`	string	Дата й час створення, ISO 8601
`updatedAt`	string	Дата й час останнього оновлення, ISO 8601

Посилання у полі photos[].url — тимчасові підписані URL зі строком дії. Не зберігайте їх як постійні посилання; за потреби кешувати зображення завантажте файл і збережіть його на своїй стороні, або повторно запитуйте ендпоінт перед показом.

Список товарів#

Повертає всі товари студії, відсортовані за id у спадному порядку. Список включає як активні, так і приховані (isActive: false) товари.

GET /products

Приклад запиту

curl https://placraftic.com/api/v1/products \
  -H "Authorization: Bearer pk_live_..."

Приклад відповіді

{
  "data": [
    {
      "id": 2,
      "title": "Тест 1",
      "description": "Опис товару 1",
      "photos": [
        { "url": "https://.../products/2/photo1.jpg?X-Amz-Signature=...", "objectKey": "products/2/photo1.jpg" }
      ],
      "price": { "amount": "350.00", "currency": { "id": 5, "code": "UAH", "name": "Ukrainian Hryvnia", "symbol": "₴" } },
      "leadTime": 3,
      "isActive": true,
      "studioId": 1,
      "createdAt": "2026-06-01T10:00:00+00:00",
      "updatedAt": "2026-06-15T12:30:00+00:00"
    }
  ]
}

Отримати товар#

Повертає один товар за ідентифікатором.

GET /products/{id}

Параметри шляху

Параметр	Тип	Опис
`id`	integer	Ідентифікатор товару

Приклад запиту

curl https://placraftic.com/api/v1/products/2 \
  -H "Authorization: Bearer pk_live_..."

Приклад відповіді

{
  "data": {
    "id": 2,
    "title": "Тест 1",
    "description": "Опис товару 1",
    "photos": [
      { "url": "https://.../products/2/photo1.jpg?X-Amz-Signature=...", "objectKey": "products/2/photo1.jpg" }
    ],
    "price": { "amount": "350.00", "currency": { "id": 5, "code": "UAH", "name": "Ukrainian Hryvnia", "symbol": "₴" } },
    "leadTime": 3,
    "isActive": true,
    "studioId": 1,
    "createdAt": "2026-06-01T10:00:00+00:00",
    "updatedAt": "2026-06-15T12:30:00+00:00"
  }
}

Помилки

Код	Причина
`404`	Товар з таким `id` не існує або належить іншій студії