Ürün türleri API

Ürün türleri ve renk, beden, malzeme gibi yeniden kullanılabilir özellikler.

Modül kodu attributes · 14 işlem · 8 veri modeli · 10 olay. Bir anahtar ya da token, arkasındaki kişinin bu modülde yapabildiğinden fazlasını asla yapamaz; satır düzeyindeki güvenlik uygulamadakiyle birebir aynıdır. Yetki kapsamları: attributes (hepsi), attributes:read (yalnız okuma) ya da attributes:<yetenek>.

Kaynaklar

Listeler limit (en çok 200), cursor, order (ör. -created_at), fields ve q alır; diğer her sorgu parametresi bir sütun süzgecidir: ?status=paid, ?total[gte]=100, ?id[in]=a,b, ?x=null.

İşlemler

attributes.assign_attributes

Tipe özellik ekle — Ürün seviyesinde ya da varyant seviyesinde — isteğe bağlı olarak varyant seçiciyi yönlendirir.

Gereken izin attributes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.assign_attributes

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.type_attributes_changed, attributes.variant_axes_synced

Neye yazar: attribute_item_option (upsert) — Maps a picker attribute onto the catalogue axis (item.md §9b); product_type_attribute (insert) — Assigns the attributes

curl -X POST https://app.getera.io/api/v1/attribute_item_options/actions/assign_attributes \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"productTypeId":"PRODUCT_TYPE_ID","attributeIds":{},"level":"product"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.type_attributes_changed",
    "attributes.variant_axes_synced"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeItemOptions.assignAttributes({
  productTypeId: "PRODUCT_TYPE_ID",
  attributeIds: {},
  level: "product"
})

era attribute_item_options assign_attributes --data '{"productTypeId":"PRODUCT_TYPE_ID","attributeIds":{},"level":"product"}'

{
  "name": "era__attributes__assign_attributes",
  "arguments": {
    "productTypeId": "PRODUCT_TYPE_ID",
    "attributeIds": {},
    "level": "product"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, attribute_already_assigned, variant_only_attribute, variant_selection_not_allowed · 429 çok sık istek

attributes.delete_attribute

Özelliği sil — Seçenekleri, atamaları ve her ürünün buna ait değeri de gider.

Gereken izin attributes:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• REST kısayolu: DELETE /api/v1/attributes/{id}
• Asıl adres: POST /api/v1/actions/attributes.delete_attribute

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.attribute_deleted

Neye yazar: attribute (delete) — Removes it; the FKs remove what hangs off it

curl -X POST https://app.getera.io/api/v1/attributes/ATTRIBUTE_ID/actions/delete_attribute \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.attribute_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributes.deleteAttribute("ATTRIBUTE_ID")

era attributes delete_attribute ATTRIBUTE_ID

{
  "name": "era__attributes__delete_attribute",
  "arguments": {
    "id": "ATTRIBUTE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

attributes.delete_attribute_value

Seçeneği kaldır — Onu seçmiş ürünler o değeri kaybeder.

Gereken izin attributes:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• REST kısayolu: DELETE /api/v1/attribute_values/{id}
• Asıl adres: POST /api/v1/actions/attributes.delete_attribute_value

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.attribute_values_changed

Neye yazar: attribute_value (delete) — Removes the choice

curl -X POST https://app.getera.io/api/v1/attribute_values/ATTRIBUTE_VALUE_ID/actions/delete_attribute_value \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.attribute_values_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeValues.deleteAttributeValue("ATTRIBUTE_VALUE_ID")

era attribute_values delete_attribute_value ATTRIBUTE_VALUE_ID

{
  "name": "era__attributes__delete_attribute_value",
  "arguments": {
    "id": "ATTRIBUTE_VALUE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found · 429 çok sık istek

attributes.delete_product_type

Ürün tipini sil — Yalnızca o tipte hiç ürün yokken. Ürünleri de silmek yerine reddeder.

Gereken izin attributes:delete · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• REST kısayolu: DELETE /api/v1/product_types/{id}
• Asıl adres: POST /api/v1/actions/attributes.delete_product_type

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.product_type_deleted

Neye yazar: product_type (delete) — Removes the type and its assignments

curl -X POST https://app.getera.io/api/v1/product_types/PRODUCT_TYPE_ID/actions/delete_product_type \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.product_type_deleted"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.productTypes.deleteProductType("PRODUCT_TYPE_ID")

era product_types delete_product_type PRODUCT_TYPE_ID

{
  "name": "era__attributes__delete_product_type",
  "arguments": {
    "id": "PRODUCT_TYPE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:delete izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, product_type_in_use · 429 çok sık istek

attributes.reorder_attribute_values

Seçenekleri sırala — Bir seçicinin onları listelediği sıra.

Gereken izin attributes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.reorder_attribute_values

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.attribute_values_changed

Neye yazar: attribute_value (update) — Rewrites sort_order

curl -X POST https://app.getera.io/api/v1/attribute_values/actions/reorder_attribute_values \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"attributeId":"ATTRIBUTE_ID","valueIds":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.attribute_values_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeValues.reorderAttributeValues({
  attributeId: "ATTRIBUTE_ID",
  valueIds: {}
})

era attribute_values reorder_attribute_values --data '{"attributeId":"ATTRIBUTE_ID","valueIds":{}}'

{
  "name": "era__attributes__reorder_attribute_values",
  "arguments": {
    "attributeId": "ATTRIBUTE_ID",
    "valueIds": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, value_not_of_attribute · 429 çok sık istek

attributes.reorder_type_attributes

Tipin özelliklerini sırala — Ürün ve varyant formlarının onları gösterdiği sıra.

Gereken izin attributes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.reorder_type_attributes

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.type_attributes_changed

Neye yazar: product_type_attribute (update) — Rewrites sort_order

curl -X POST https://app.getera.io/api/v1/product_type_attributes/actions/reorder_type_attributes \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"productTypeId":"PRODUCT_TYPE_ID","level":"product","attributeIds":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.type_attributes_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.productTypeAttributes.reorderTypeAttributes({
  productTypeId: "PRODUCT_TYPE_ID",
  level: "product",
  attributeIds: {}
})

era product_type_attributes reorder_type_attributes --data '{"productTypeId":"PRODUCT_TYPE_ID","level":"product","attributeIds":{}}'

{
  "name": "era__attributes__reorder_type_attributes",
  "arguments": {
    "productTypeId": "PRODUCT_TYPE_ID",
    "level": "product",
    "attributeIds": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, attribute_not_on_type · 429 çok sık istek

attributes.save_attribute

Özelliği kaydet — Yeniden kullanılabilir bir özellik — renk, beden, malzeme — ve nasıl girilip gösterildiği.

Gereken izin attributes:manage · veriyi değiştirir

• REST kısayolu: PATCH /api/v1/attributes/{id}
• Asıl adres: POST /api/v1/actions/attributes.save_attribute

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.attribute_saved

Neye yazar: attribute (upsert) — Creates or edits the attribute; attribute_value (insert) — Writes the first choices on create

curl -X POST https://app.getera.io/api/v1/attributes/ATTRIBUTE_ID/actions/save_attribute \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.attribute_saved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributes.saveAttribute("ATTRIBUTE_ID", {
  name: "Name"
})

era attributes save_attribute ATTRIBUTE_ID \
  --name "Name"

{
  "name": "era__attributes__save_attribute",
  "arguments": {
    "id": "ATTRIBUTE_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_name, not_found, input_type_locked, slug_taken, entity_type_required, entity_type_not_allowed, unit_not_allowed, property_not_allowed, attribute_has_no_choices, value_name_taken · 429 çok sık istek

attributes.save_attribute_value

Seçeneği kaydet — Bir açılır listenin, çoklu seçimin veya renk örneğinin bir seçeneği.

Gereken izin attributes:manage · veriyi değiştirir

• REST kısayolu: PATCH /api/v1/attribute_values/{id}
• Asıl adres: POST /api/v1/actions/attributes.save_attribute_value

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.attribute_values_changed, attributes.variant_axes_synced

Neye yazar: attribute_item_option (upsert) — Maps a picker attribute onto the catalogue axis (item.md §9b); attribute_value (upsert) — Creates or edits the choice

curl -X POST https://app.getera.io/api/v1/attribute_values/ATTRIBUTE_VALUE_ID/actions/save_attribute_value \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"attributeId":"ATTRIBUTE_ID","name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.attribute_values_changed",
    "attributes.variant_axes_synced"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeValues.saveAttributeValue("ATTRIBUTE_VALUE_ID", {
  attributeId: "ATTRIBUTE_ID",
  name: "Name"
})

era attribute_values save_attribute_value ATTRIBUTE_VALUE_ID \
  --attribute-id "ATTRIBUTE_ID" \
  --name "Name"

{
  "name": "era__attributes__save_attribute_value",
  "arguments": {
    "id": "ATTRIBUTE_VALUE_ID",
    "attributeId": "ATTRIBUTE_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, attribute_has_no_choices, invalid_name, swatch_only_field, invalid_swatch, value_name_taken · 429 çok sık istek

attributes.save_product_type

Ürün tipini kaydet — Bir ürün türü ve ürünlerinin taşıdığı özellik seti.

Gereken izin attributes:manage · veriyi değiştirir

• REST kısayolu: PATCH /api/v1/product_types/{id}
• Asıl adres: POST /api/v1/actions/attributes.save_product_type

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.product_type_saved

Neye yazar: product_type (upsert) — Creates or edits the type

curl -X POST https://app.getera.io/api/v1/product_types/PRODUCT_TYPE_ID/actions/save_product_type \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Name"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.product_type_saved"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.productTypes.saveProductType("PRODUCT_TYPE_ID", {
  name: "Name"
})

era product_types save_product_type PRODUCT_TYPE_ID \
  --name "Name"

{
  "name": "era__attributes__save_product_type",
  "arguments": {
    "id": "PRODUCT_TYPE_ID",
    "name": "Name"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 invalid_name, slug_taken, not_found, product_type_in_use · 429 çok sık istek

attributes.set_item_attributes

Ürünün özelliklerini doldur — Ürün seviyesindeki değerler — malzeme, marka serisi, bakım talimatı.

Gereken izin attributes:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.set_item_attributes

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.item_attributes_changed

Neye yazar: item_attribute_value (upsert) — Replaces the values of each attribute sent

curl -X POST https://app.getera.io/api/v1/product_attribute_values/actions/set_item_attributes \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"itemId":"ITEM_ID","values":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.item_attributes_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.productAttributeValues.setItemAttributes({
  itemId: "ITEM_ID",
  values: {}
})

era product_attribute_values set_item_attributes --data '{"itemId":"ITEM_ID","values":{}}'

{
  "name": "era__attributes__set_item_attributes",
  "arguments": {
    "itemId": "ITEM_ID",
    "values": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found, item_has_no_type, attribute_not_on_type, attribute_value_invalid, attribute_value_required · 429 çok sık istek

attributes.set_item_type

Ürüne ürün tipini ver — Bir kez seçilir — ürünün hangi özellikleri taşıyacağına karar verir.

Gereken izin attributes:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.set_item_type

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.item_type_set, attributes.variant_axes_synced

Neye yazar: attribute_item_option (upsert) — Maps a picker attribute onto the catalogue axis (item.md §9b); item_product_type (insert) — Records the item’s type

curl -X POST https://app.getera.io/api/v1/attribute_item_options/actions/set_item_type \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"itemId":"ITEM_ID","productTypeId":"PRODUCT_TYPE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.item_type_set",
    "attributes.variant_axes_synced"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeItemOptions.setItemType({
  itemId: "ITEM_ID",
  productTypeId: "PRODUCT_TYPE_ID"
})

era attribute_item_options set_item_type \
  --item-id "ITEM_ID" \
  --product-type-id "PRODUCT_TYPE_ID"

{
  "name": "era__attributes__set_item_type",
  "arguments": {
    "itemId": "ITEM_ID",
    "productTypeId": "PRODUCT_TYPE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 item_not_found, not_found, item_type_locked, type_does_not_fit_item · 429 çok sık istek

attributes.set_variant_attributes

Varyantın özelliklerini doldur — Varyant seviyesindeki değerler — beden, renk — seçiciyi yönlendirenler dâhil.

Gereken izin attributes:write · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.set_variant_attributes

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.variant_attributes_changed, attributes.variant_axes_synced

Neye yazar: attribute_item_option (upsert) — Maps a picker attribute onto the catalogue axis (item.md §9b); variant_attribute_value (upsert) — Replaces the values of each attribute sent

curl -X POST https://app.getera.io/api/v1/attribute_item_options/actions/set_variant_attributes \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"itemVariantId":"ITEM_VARIANT_ID","values":{}}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.variant_attributes_changed",
    "attributes.variant_axes_synced"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeItemOptions.setVariantAttributes({
  itemVariantId: "ITEM_VARIANT_ID",
  values: {}
})

era attribute_item_options set_variant_attributes --data '{"itemVariantId":"ITEM_VARIANT_ID","values":{}}'

{
  "name": "era__attributes__set_variant_attributes",
  "arguments": {
    "itemVariantId": "ITEM_VARIANT_ID",
    "values": {}
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:write izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 variant_not_found, item_has_no_type, attribute_not_on_type, attribute_value_invalid, attribute_value_required · 429 çok sık istek

attributes.unassign_attribute

Özelliği tipten kaldır — O tipteki ürünlerin bu özellik için taşıdığı değerler de gider.

Gereken izin attributes:manage · siler ya da geri alınamaz · Era çalıştırırken bir kişiye onaylatır

• Asıl adres: POST /api/v1/actions/attributes.unassign_attribute

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.type_attributes_changed

Neye yazar: product_type_attribute (delete) — Removes the assignment; item_attribute_value (delete) — Removes products’ values for it; variant_attribute_value (delete) — Removes variants’ values for it

curl -X POST https://app.getera.io/api/v1/product_type_attributes/actions/unassign_attribute \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"productTypeId":"PRODUCT_TYPE_ID","attributeId":"ATTRIBUTE_ID"}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.type_attributes_changed"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.productTypeAttributes.unassignAttribute({
  productTypeId: "PRODUCT_TYPE_ID",
  attributeId: "ATTRIBUTE_ID"
})

era product_type_attributes unassign_attribute \
  --product-type-id "PRODUCT_TYPE_ID" \
  --attribute-id "ATTRIBUTE_ID"

{
  "name": "era__attributes__unassign_attribute",
  "arguments": {
    "productTypeId": "PRODUCT_TYPE_ID",
    "attributeId": "ATTRIBUTE_ID"
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, attribute_not_on_type · 429 çok sık istek

attributes.update_assignment

Varyant seçiciyi değiştir — Bir varyant özelliğinin sitede “Beden: S M L” düğmeleri olarak görünüp görünmediği.

Gereken izin attributes:manage · veriyi değiştirir

• Asıl adres: POST /api/v1/actions/attributes.update_assignment

Girdi

Ön koşullar

Koşul tutmazsa işlem 409 ve şu kodlardan biriyle reddedilir:

Yayımladığı olaylar: attributes.type_attributes_changed, attributes.variant_axes_synced

Neye yazar: attribute_item_option (upsert) — Maps a picker attribute onto the catalogue axis (item.md §9b); product_type_attribute (update) — Sets variant_selection

curl -X POST https://app.getera.io/api/v1/attribute_item_options/actions/update_assignment \
  -H "Authorization: Bearer $ERA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"productTypeId":"PRODUCT_TYPE_ID","attributeId":"ATTRIBUTE_ID","variantSelection":true}'

{
  "ok": true,
  "result": "…",
  "events": [
    "attributes.type_attributes_changed",
    "attributes.variant_axes_synced"
  ]
}

import { createEra } from "@getera/sdk"

const era = createEra({ apiKey: process.env.ERA_API_KEY })
const res = await era.attributeItemOptions.updateAssignment({
  productTypeId: "PRODUCT_TYPE_ID",
  attributeId: "ATTRIBUTE_ID",
  variantSelection: true
})

era attribute_item_options update_assignment \
  --product-type-id "PRODUCT_TYPE_ID" \
  --attribute-id "ATTRIBUTE_ID" \
  --variant-selection true

{
  "name": "era__attributes__update_assignment",
  "arguments": {
    "productTypeId": "PRODUCT_TYPE_ID",
    "attributeId": "ATTRIBUTE_ID",
    "variantSelection": true
  }
}

Hatalar: 401 kimlik bilgisi yok ya da süresi dolmuş · 403 kimlik bilgisinde attributes:manage izni yok · 404 kayıt ya da modül erişim dışında · 422 geçersiz girdi (problems[]) · 409 not_found, attribute_not_on_type, variant_selection_not_allowed · 429 çok sık istek

Veri modelleri

AttributeItemOption

Tablo attribute_item_option · Kaynak attribute_item_options

• GET /api/v1/attribute_item_options
• GET /api/v1/attribute_item_options/{id}

Birincil anahtar: id

Tekil: item_id, attribute_id · item_option_id

AttributeValue

Tablo attribute_value · Kaynak attribute_values

• GET /api/v1/attribute_values
• GET /api/v1/attribute_values/{id}
• PATCH /api/v1/attribute_values/{id} → attributes.save_attribute_value
• DELETE /api/v1/attribute_values/{id} → attributes.delete_attribute_value

Birincil anahtar: id

Tekil: attribute_id, slug

Denetimler:

• CHECK (((value = ''::text) OR (file_id IS NULL)))

Attribute

Tablo attribute · Kaynak attributes

• GET /api/v1/attributes
• GET /api/v1/attributes/{id}
• PATCH /api/v1/attributes/{id} → attributes.save_attribute
• DELETE /api/v1/attributes/{id} → attributes.delete_attribute

Birincil anahtar: id

Denetimler:

• CHECK (((input_type = ANY (ARRAY['reference'::text, 'single-reference'::text])) = (entity_type IS NOT NULL)))
• CHECK (((unit IS NULL) OR (input_type = 'numeric'::text)))

ItemAttributeValue

Tablo item_attribute_value · Kaynak product_attribute_values

• GET /api/v1/product_attribute_values
• GET /api/v1/product_attribute_values/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((num_nonnulls(value_id, text_value, numeric_value, boolean_value, date_value, file_id, reference_item_id, reference_variant_id, reference_category_id) = 1))

ProductTypeAttribute

Tablo product_type_attribute · Kaynak product_type_attributes

• GET /api/v1/product_type_attributes
• GET /api/v1/product_type_attributes/{id}

Birincil anahtar: id

Tekil: product_type_id, attribute_id

Denetimler:

• CHECK (((level = 'variant'::text) OR (NOT variant_selection)))

ItemProductType

Tablo item_product_type · Kaynak product_type_links

• GET /api/v1/product_type_links
• GET /api/v1/product_type_links/{id}

Birincil anahtar: id

Tekil: item_id

ProductType

Tablo product_type · Kaynak product_types

• GET /api/v1/product_types
• GET /api/v1/product_types/{id}
• PATCH /api/v1/product_types/{id} → attributes.save_product_type
• DELETE /api/v1/product_types/{id} → attributes.delete_product_type

Birincil anahtar: id

Denetimler:

• CHECK ((weight_grams >= 0))

VariantAttributeValue

Tablo variant_attribute_value · Kaynak variant_attribute_values

• GET /api/v1/variant_attribute_values
• GET /api/v1/variant_attribute_values/{id}

Birincil anahtar: id

Denetimler:

• CHECK ((num_nonnulls(value_id, text_value, numeric_value, boolean_value, date_value, file_id, reference_item_id, reference_variant_id, reference_category_id) = 1))

Olaylar

İş akışları ve webhook'lar bu olaylara tepki verir.