Skip to main content

Toplu Çeviri Ekleme

Toplu olarak çeviri ekler (Admin).

Endpoint

POST /api/v1/admin/translations/bulk

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

  • translations.create - Çeviri oluşturma

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 (varsayılan: true)

Example Request

{
"translations": [
{
"key": "pages.home",
"values": {
"tr": "Ana Sayfa",
"en": "Home Page",
"de": "Startseite"
},
"group": "pages",
"description": "Ana sayfa başlığı"
},
{
"key": "pages.about",
"values": {
"tr": "Hakkımızda",
"en": "About Us"
},
"group": "pages"
}
]
}

Response

Success Response (201 Created)

{
"message": "Bulk translation creation completed",
"created": 5,
"skipped": 0,
"errors": 0,
"data": {
"created": [
{
"id": 1,
"key": "pages.home",
"locale": "tr",
"value": "Ana Sayfa"
}
],
"skipped": [],
"errors": []
}
}

Error Responses

403 Forbidden

{
"message": "Forbidden"
}

422 Unprocessable Entity

{
"message": "Validation failed",
"errors": {
"translations": ["The translations field is required."]
}
}

Code Examples

cURL

curl -X POST 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",
"en": "Home Page"
},
"group": "pages"
}
]
}'

Notes

  • Toplu ekleme için translations array formatı kullanılır
  • Her çeviri için her dil için ayrı kayıt oluşturulur
  • Aynı key + locale kombinasyonu zaten varsa skip edilir
  • Çeviriler oluşturulduktan sonra cache otomatik temizlenir
  • Response'da created, skipped ve errors sayıları döner