Ana içeriğe geç

Toplu Çeviri Güncelleme

Toplu olarak çeviri günceller (Admin - upsert).

Endpoint

PUT /api/v1/admin/translations/bulk
PATCH /api/v1/admin/translations/bulk

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

  • translations.update - Çeviri güncelleme

Request

Headers

HeaderDeğerZorunlu
AuthorizationBearer \{token\}Evet
Content-Typeapplication/jsonEvet

Request Body

ParametreTipZorunluAçıklama
translationsarrayEvetÇeviri dizisi (min: 1)
translations[].keystringEvetÇeviri anahtarı
translations[].valuesobjectEvetDil kodları ve çeviri metinleri
translations[].groupstringHayırGrup adı
translations[].descriptionstringHayırAçıklama
translations[].is_activebooleanHayırAktif durumu

Example Request

{
"translations": [
{
"key": "pages.home",
"values": {
"tr": "Ana Sayfa (Güncellendi)",
"en": "Home Page (Updated)"
},
"group": "pages"
},
{
"key": "pages.about",
"values": {
"tr": "Hakkımızda (Güncellendi)"
}
}
]
}

Response

Success Response (200 OK)

{
"message": "Bulk translation update completed",
"updated": 3,
"created": 1,
"skipped": 0,
"errors": 0,
"data": {
"updated": [
{
"id": 1,
"key": "pages.home",
"locale": "tr",
"value": "Ana Sayfa (Güncellendi)"
}
],
"created": [
{
"id": 5,
"key": "pages.about",
"locale": "en",
"value": "About Us"
}
],
"skipped": [],
"errors": []
}
}

Code Examples

cURL

curl -X PUT https://api.example.com/api/v1/admin/translations/bulk \
-H "Authorization: Bearer \{token\}" \
-H "Content-Type: application/json" \
-d '{
"translations": [
{
"key": "pages.home",
"values": {
"tr": "Ana Sayfa (Güncellendi)",
"en": "Home Page (Updated)"
}
}
]
}'

Notes

  • Toplu güncelleme için translations array formatı kullanılır
  • Key + locale kombinasyonu ile çeviri bulunur veya oluşturulur (upsert)
  • Mevcut çeviriler güncellenir, yoksa yeni oluşturulur
  • Çeviriler güncellendikten sonra cache otomatik temizlenir
  • Response'da updated, created, skipped ve errors sayıları döner