Çok dilli içerik
Çok dilli bir mağazada kaydın varsayılan dildeki metni kaynağın kendi alanlarındadır (name, title, detail…). Diğer dillerdeki karşılıklar her çok dilli kaynakta aynı biçimde, translations alanında durur:
"translations": {
"en": { "title": "Summer collection", "summary": "New arrivals", "detail": "<p>…</p>", "seoTitle": null },
"ar": { "title": "مجموعة الصيف", "summary": null, "detail": null, "seoTitle": null }
}
- Anahtar dil kodudur; içindeki alan adları kaynağın kendi alan adlarıdır.
- Varsayılan dil
translationsiçinde yer almaz. Mağazanın varsayılan dili ve açık dilleri için Diller. - Yalnız mağazada açık ya da lisanslı diller döner. Hiç çevirisi olmayan dil dönmez; çevrilmemiş alan
nulldöner. - Çeviri ayrı bir kapsam istemez: kaydı okuyabiliyorsanız çevirisini okur, güncelleyebiliyorsanız çevirisini yazarsınız (aşağıdaki tablo).
Okuma
translations tek kayıt okumada (GET /{kaynak}/{id}) ve oluşturma ya da güncelleme yanıtında döner. Listede her kayıt için ayrıca okunduğundan varsayılan olarak dönmez; gerekiyorsa alan seçimiyle isteyin:
curl 'https://<domain>/api/v3/admin/2026-01/cms/blogs?fields[blogs]=title,translations&page[size]=50' \
-H 'Authorization: Bearer <access_token>' \
-H 'Accept: application/vnd.api+json'
Yazma
Çeviriyi kaydı güncellediğiniz istekte translations ile gönderirsiniz. Yazma kısmidir:
- Yalnız gönderdiğiniz dil ve alan değişir; gönderilmeyen diller ve alanlar korunur.
nullo dildeki alanın çevirisini siler.- Aynı istekte birden çok dil gönderebilirsiniz.
- Yalnız
translationsgönderirseniz kaydın kendisi (varsayılan dil) güncellenmez. - Kayıt oluştururken (
POST) de gönderebilirsiniz.
curl -X PATCH https://<domain>/api/v3/admin/2026-01/cms/blogs/43 \
-H 'Authorization: Bearer <access_token>' \
-H 'Accept: application/vnd.api+json' \
-H 'Content-Type: application/vnd.api+json' \
-d '{
"data": {
"type": "blogs",
"id": "43",
"attributes": {
"translations": {
"en": { "title": "Summer collection", "summary": "New arrivals" }
}
}
}
}'
Yanıtta kaydın güncel translations alanı döner. Örnekte İngilizce detail daha önce yazıldıysa yerinde kalır.
null olan alanları gönderin. Panel kullanıcısının elle girdiği çeviriyi bu sayede ezmezsiniz. Uygulama yazmadan kendi sunucunuzdan çağıracaksanız Mağazaya özel entegrasyon.Kurallar
| Durum | Yanıt |
|---|---|
Varsayılan dil kodu (translations.tr gibi) | 422 — varsayılan dil kaynağın kendi alanlarıyla yazılır |
| Mağazada açık ya da lisanslı olmayan dil | 422 |
Kaynakta çevrilemeyen alan (ör. listNo) | 422, hata çevrilebilir alanları listeler |
| Salt okunur alan (diğer dildeki SEO bağlantısı) | 422 |
| Metin olmayan değer | 422 |
seoTitle, seoDescription 255 karakterden uzun | 422 |
SEO bağlantısı (seoLink, ürün ve kategoride slug): diğer dildeki bağlantı okunur ama translations ile yazılamaz.
Görseller çeviriye dahil değildir; görseller her dilde aynıdır.
Çevirisi olan kaynaklar
Yalnız uç noktanın son parçası verilmiştir; tam adres /api/v3/admin/2026-01 ile başlar.
Katalog
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/catalog/products | slug (salt okunur), name, additionalInfo1, additionalInfo2, additionalInfo3, shortDescription, detail, document, warrantyInfo, deliveryInfo | read_products | write_products |
/catalog/variants | additionalInfo | read_products | write_products |
/catalog/variant-groups | groupName | read_products | write_products |
/catalog/variant-group-options | name | read_products | write_products |
/catalog/categories | name, slug (salt okunur), seoTitle, seoDescription | read_products | write_products |
/catalog/brands | name, shortDescription, seoLink (salt okunur) | read_products | write_products |
/catalog/models | name | read_products | write_products |
/catalog/tags | name, isTopShowcase, isBottomShowcase, isTopShowcaseMobile, isBottomShowcaseMobile, seoLink (salt okunur) | read_products | write_products |
/catalog/filter-groups | name | read_products | write_products |
/catalog/filter-options | name | read_products | write_products |
/catalog/stock-units | name | read_inventory | write_inventory |
Vitrin ve kombin
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/catalog/category-showcases | showcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobile, showcaseTopMobileApp, showcaseLowerMobileApp | read_merchandising | write_merchandising |
/catalog/brand-showcases | showcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobile | read_merchandising | write_merchandising |
/catalog/model-showcases | showcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobile | read_merchandising | write_merchandising |
/catalog/combines | name, description, seoLink (salt okunur) | read_merchandising | write_merchandising |
/catalog/combine-categories | name, description | read_merchandising | write_merchandising |
/catalog/combine-category-showcases | showcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobile | read_merchandising | write_merchandising |
İçerik
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/cms/blogs | title, summary, detail, seoLink (salt okunur), seoTitle, seoDescription | read_content | write_content |
/cms/blog-categories | name, seoLink (salt okunur), seoTitle, seoDescription | read_content | write_content |
/cms/contents | name, content, seoLink (salt okunur) | read_content | write_content |
/cms/news | seoLink (salt okunur), name, detailTitle, summaryContent, detailContent | read_content | write_content |
/cms/faqs | name, content | read_content | write_content |
/cms/faq-categories | name, seoLink (salt okunur) | read_content | write_content |
/cms/video-galleries | title, embed, tag, topic | read_content | write_content |
/cms/video-gallery-categories | name, seoLink (salt okunur) | read_content | write_content |
Tema
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/online-store/menu-items | name, url, data1, data2, content | read_themes | write_themes |
Müşteri
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/customer/customer-fields | field, options | read_customer_groups | write_customer_groups |
/customer/wishlist-categories | name | read_customers | — (yalnız okunur) |
/customer/message-departments | name | read_customer_messages | — (yalnız okunur) |
/crm/ticket-departments | name | read_customer_messages | — (yalnız okunur) |
Sipariş, ödeme ve kargo
| Kaynak | Çevrilebilir alanlar | Okuma | Yazma |
|---|---|---|---|
/order/order-statuses | name, nameSeenByUser | read_orders | — (yalnız okunur) |
/order/order-return-statuses | name | read_returns | — (yalnız okunur) |
/order/order-return-reasons | name | read_returns | write_returns |
/order/payment-methods | name, explanation, confirmationStatement, virtualPosApprovalProcessDescription, confirmationEmail, confirmationEmailTitle, paymentReceivedEmail, paymentReceivedEmailTitle, invoiceAdditionalServiceDescription | read_payment_methods | — (yalnız okunur) |
/order/cargo-companies | name, description | read_shipping | write_shipping |
/campaign/campaigns | name, description, cartDescription | read_discounts | write_discounts |
/config/currencies | name | read_store | write_currencies |