TracePass
Започнете
Продукти

Актуализиране на продукт

Patch на едно или повече полета на продукт. Изпратете само ключовете, които искате да промените — пропуснатите полета остават непроменени. Семантиката на цял масив за imageUrls е умишлена: CMS на клиента е каноничният източник на изображения, така че PATCH с imageUrls: ["a","b"] заменя предишните. За добавяне на едно изображение без презаписване, използвайте multipart upload endpoint.

PATCH/api/v1/products/{id}
Изтегли OpenAPI 3.1
PATCH/api/v1/products/{id}

Актуализиране на продукт

Patch на едно или повече полета на продукт. Изпратете само ключовете, които искате да промените — пропуснатите полета остават непроменени. Семантиката на цял масив за imageUrls е умишлена: CMS на клиента е каноничният източник на изображения, така че PATCH с imageUrls: ["a","b"] заменя предишните. За добавяне на едно изображение без презаписване, използвайте multipart upload endpoint.

Брои се като едно v1 записване. Поддържа Idempotency-Key. Уникалността на model се проверява отново при промяна; description: null изчиства описанието (различно от пропускане на ключа).

Параметри в пътя

  • idзадължително

    string (24 hex chars)

    ID на продукта.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Хедъри

  • Authorizationзадължително

    string

    Bearer <token> — или tp_ API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • Idempotency-Key

    string

    UUID v4.

Полета в тялото

  • name

    string (1-200)

    Показвано име.

  • model

    string (1-100)

    Идентификатор на модел. Уникалността се проверява при промяна.

  • description

    string | null (≤ 2000)

    Подайте null за изчистване.

  • defaultFieldValues

    object

    Заменя seed стойностите за бъдещи паспорти. Всяка стойност се проверява спрямо шаблона: числов низ за числово поле се записва като число, а всяка друга стойност, която шаблонът отхвърля, връща 400 Invalid default field values с details.

  • imageUrls

    string[] (max 20)

    Заменя пълния масив от изображения.

  • sourceLocale

    string (ISO 639-1)

    Актуализира локала на name / description.

Заявка

curl -sS -X PATCH \
  https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Li-Ion 48V Battery Pack (revised)",
    "imageUrls": ["https://cdn.example.com/new-hero.jpg"]
  }'

Отговор

{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "name": "Li-Ion 48V Battery Pack (revised)",
  "imageUrls": ["https://cdn.example.com/new-hero.jpg"],
  "updatedAt": "2026-05-09T15:30:00.000Z"
}

Свързани endpoints