Постобробка

Послуга постобробки — це додаткова операція над надрукованою моделлю (шліфування, фарбування, склеювання тощо), яку можна додати до позиції замовлення. Кожна послуга оцінюється або фіксованою сумою (price), або відсотком від вартості позиції (pricePercentage) — заповнене завжди рівно одне з цих двох полів.

finishingIds, передані при розрахунку вартості та створенні замовлення, мають відповідати послугам, що належать вашій студії.

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

Об'єкт Finishing#

Поле	Тип	Опис
`id`	integer	Унікальний ідентифікатор послуги
`name`	string	Назва послуги (наприклад, «Шліфування»)
`description`	string \| null	Опис послуги
`price`	Money \| null	Фіксована ціна послуги. `null`, якщо ціна встановлена у відсотках
`pricePercentage`	string \| null	Ціна у відсотках від вартості позиції, наприклад `"10.00"`. `null`, якщо ціна фіксована
`studioId`	integer	Ідентифікатор студії-власника
`technology`	Technology	Технологія друку, для якої призначена послуга

Список послуг постобробки#

Повертає всі послуги постобробки студії, відсортовані за id у спадному порядку.

GET /finishings

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

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

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

{
  "data": [
    {
      "id": 8,
      "name": "Шліфування",
      "description": "Ручне шліфування поверхні",
      "price": { "amount": "150.00", "currency": { "id": 5, "code": "UAH", "name": "Ukrainian Hryvnia", "symbol": "₴" } },
      "pricePercentage": null,
      "studioId": 1,
      "technology": { "id": 1, "name": "FDM", "slug": "fdm", "materialCount": 0 }
    },
    {
      "id": 7,
      "name": "Фарбування",
      "description": null,
      "price": null,
      "pricePercentage": "15.00",
      "studioId": 1,
      "technology": { "id": 1, "name": "FDM", "slug": "fdm", "materialCount": 0 }
    }
  ]
}

Отримати послугу постобробки#

Повертає одну послугу постобробки за ідентифікатором.

GET /finishings/{id}

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

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

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

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

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

{
  "data": {
    "id": 8,
    "name": "Шліфування",
    "description": "Ручне шліфування поверхні",
    "price": { "amount": "150.00", "currency": { "id": 5, "code": "UAH", "name": "Ukrainian Hryvnia", "symbol": "₴" } },
    "pricePercentage": null,
    "studioId": 1,
    "technology": { "id": 1, "name": "FDM", "slug": "fdm", "materialCount": 0 }
  }
}

Помилки

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