T-SOFT/Admin API/Çok dilli içerik

Ç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 translations iç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 null dö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:

GET /cms/blogs
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.
  • null o dildeki alanın çevirisini siler.
  • Aynı istekte birden çok dil gönderebilirsiniz.
  • Yalnız translations gönderirseniz kaydın kendisi (varsayılan dil) güncellenmez.
  • Kayıt oluştururken (POST) de gönderebilirsiniz.
PATCH /cms/blogs/43
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.

Eksik çevirileri tamamlayan bir otomasyon için önce kaydı okuyun, yalnız 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

DurumYanı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 dil422
Kaynakta çevrilemeyen alan (ör. listNo)422, hata çevrilebilir alanları listeler
Salt okunur alan (diğer dildeki SEO bağlantısı)422
Metin olmayan değer422
seoTitle, seoDescription 255 karakterden uzun422

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 alanlarOkumaYazma
/catalog/productsslug (salt okunur), name, additionalInfo1, additionalInfo2, additionalInfo3, shortDescription, detail, document, warrantyInfo, deliveryInforead_productswrite_products
/catalog/variantsadditionalInforead_productswrite_products
/catalog/variant-groupsgroupNameread_productswrite_products
/catalog/variant-group-optionsnameread_productswrite_products
/catalog/categoriesname, slug (salt okunur), seoTitle, seoDescriptionread_productswrite_products
/catalog/brandsname, shortDescription, seoLink (salt okunur)read_productswrite_products
/catalog/modelsnameread_productswrite_products
/catalog/tagsname, isTopShowcase, isBottomShowcase, isTopShowcaseMobile, isBottomShowcaseMobile, seoLink (salt okunur)read_productswrite_products
/catalog/filter-groupsnameread_productswrite_products
/catalog/filter-optionsnameread_productswrite_products
/catalog/stock-unitsnameread_inventorywrite_inventory

Vitrin ve kombin

KaynakÇevrilebilir alanlarOkumaYazma
/catalog/category-showcasesshowcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobile, showcaseTopMobileApp, showcaseLowerMobileAppread_merchandisingwrite_merchandising
/catalog/brand-showcasesshowcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobileread_merchandisingwrite_merchandising
/catalog/model-showcasesshowcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobileread_merchandisingwrite_merchandising
/catalog/combinesname, description, seoLink (salt okunur)read_merchandisingwrite_merchandising
/catalog/combine-categoriesname, descriptionread_merchandisingwrite_merchandising
/catalog/combine-category-showcasesshowcaseTop, showcaseLower, showcaseTopMobile, showcaseLowerMobileread_merchandisingwrite_merchandising

İçerik

KaynakÇevrilebilir alanlarOkumaYazma
/cms/blogstitle, summary, detail, seoLink (salt okunur), seoTitle, seoDescriptionread_contentwrite_content
/cms/blog-categoriesname, seoLink (salt okunur), seoTitle, seoDescriptionread_contentwrite_content
/cms/contentsname, content, seoLink (salt okunur)read_contentwrite_content
/cms/newsseoLink (salt okunur), name, detailTitle, summaryContent, detailContentread_contentwrite_content
/cms/faqsname, contentread_contentwrite_content
/cms/faq-categoriesname, seoLink (salt okunur)read_contentwrite_content
/cms/video-galleriestitle, embed, tag, topicread_contentwrite_content
/cms/video-gallery-categoriesname, seoLink (salt okunur)read_contentwrite_content

Tema

KaynakÇevrilebilir alanlarOkumaYazma
/online-store/menu-itemsname, url, data1, data2, contentread_themeswrite_themes

Müşteri

KaynakÇevrilebilir alanlarOkumaYazma
/customer/customer-fieldsfield, optionsread_customer_groupswrite_customer_groups
/customer/wishlist-categoriesnameread_customers— (yalnız okunur)
/customer/message-departmentsnameread_customer_messages— (yalnız okunur)
/crm/ticket-departmentsnameread_customer_messages— (yalnız okunur)

Sipariş, ödeme ve kargo

KaynakÇevrilebilir alanlarOkumaYazma
/order/order-statusesname, nameSeenByUserread_orders— (yalnız okunur)
/order/order-return-statusesnameread_returns— (yalnız okunur)
/order/order-return-reasonsnameread_returnswrite_returns
/order/payment-methodsname, explanation, confirmationStatement, virtualPosApprovalProcessDescription, confirmationEmail, confirmationEmailTitle, paymentReceivedEmail, paymentReceivedEmailTitle, invoiceAdditionalServiceDescriptionread_payment_methods— (yalnız okunur)
/order/cargo-companiesname, descriptionread_shippingwrite_shipping
/campaign/campaignsname, description, cartDescriptionread_discountswrite_discounts
/config/currenciesnameread_storewrite_currencies