Skip to main content
Slovník atributů je kanonický registr produktových polí vaší společnosti. Každý sdílený atribut má stabilní UUID, aktuální key, label a type. Produktová schémata a produkty Katalogu připojují UUID, takže přejmenování klíče nemění identitu.

​
Proč atributy jsou důležité

  • Konzistence — Jedna definice pro color platí všude, bez duplikace konfigurace sloupce v každém schématu.
  • Synchronizace — Externí PIM a dodavatelské feedy mohou upsertovat atributy přes API.
  • Katalog — Produktové attributes v katalogu používají stejné klíče jako slovník.

​
Identita a životní cyklus

API vrací id, key, type, language, konfiguraci typu, status, archived_at a časová razítka revize. GET /attributes vrací standardně aktivní atributy. Parametr include_archived=true přidá archivované definice. Typ atributu a druh relace nelze u existujícího klíče změnit. Pomocí expected_updated_at můžete odhalit zastaralý zápis.

​
Synchronizované vs ruční atributy

Atributy importované z externího zdroje mohou mít nastavené source_id. Synchronizované atributy nemohou měnit label ani enum hodnoty, dokud je odpojíte (detach: true při aktualizaci).

​
Správa přes API

Použijte API atributů pro list, vytvoření, aktualizaci, přejmenování a smazání. Bulk upsert podporuje synchronizaci velkých sad atributů.

​
Bezpečné přejmenování a smazání

Přejmenování změní kanonický klíč a podporovaná závislá data atomicky. Blokované, konfliktní, souběžné nebo zastaralé přejmenování vrátí 409 bez částečného dokončení. Při opakování požadavku s nejistým výsledkem předejte ID atributu v attribute_id. Trvalé smazání je bezpečné vůči závislostem. DELETE /attributes/{key} vrátí 409 attribute_in_use, pokud atribut používá schéma, tabulka, produkt Katalogu, mapování nebo feed. Žádnou závislost automaticky nemaže.

​
Rozšíření jednoho produktu Katalogu

Produkt může připojit až 2 000 aktivních sdílených atributů bez rozšíření základního produktového schématu. Jejich UUID odešlete v attribute_extension_ids. Odpověď je uvádí v attribute_extensions.