Metin çevir (ücretli)


POST https://app.apsilo.com/api/public/v1/translate

Kaynak dili algılar ve metni hedef dile çevirir. Ücret: çevrilen metnin her başlayan 1.000 karakteri için çeviri birim fiyatı; metin zaten hedef dildeyse ücret alınmaz. Bakiye yetmezse 402 döner ve çeviri yapılmaz. Mesaj nesnelerindeki translation alanı gelen mesajların hazır çevirisini taşır.

Gerekli kapsam: translation:use

Parametreler

Parametre	Yer	Tip	Gereklilik	Açıklama
`Idempotency-Key`	başlık	string	isteğe bağlı	İsteğe özgü benzersiz değer (1–255 yazdırılabilir ASCII; ör. UUID). Aynı anahtar + aynı yol ve gövde 24 saat içinde kaydedilmiş yanıtı döner (`Idempotent-Replayed: true`); farklı gövde veya işlenmekte olan istek `409 IDEMPOTENCY_CONFLICT`. Hata yanıtları saklanmaz.
`X-Request-Id`	başlık	string	isteğe bağlı	İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, `._:-`); yanıtta aynen döner ve kayıtlara işlenir.

İstek gövdesi

Alan	Tip	Gereklilik	Açıklama
`text`	string	zorunlu	Çevrilecek metin
`to`	`tr` · `en` · `ar` · `ru` · `de` · `fr` · `es` · `it` · `nl` · `pt` · `fa` · `az` · `uk` · `bg` · `ro` · `pl` · `el` · `sq` · `sr` · `ka` · `kk` · `uz` · `he` · `zh` · `ja` · `ko`	zorunlu	Hedef dil (ISO 639-1)


{
  "text": "Merhaba, başvurunuz alınmıştır.",
  "to": "ar"
}

Yanıtlar

Durum	Açıklama
`200`	Çeviri
`401`	Kimlik doğrulanamadı. Olası kodlar: `API_KEY_INVALID`, `API_KEY_REVOKED`, `API_KEY_EXPIRED`.
`402`	Bakiye yetersiz. Olası kodlar: `INSUFFICIENT_BALANCE`.
`403`	Erişim reddedildi. Olası kodlar: `FEATURE_NOT_LICENSED`, `API_SCOPE_MISSING`, `IP_NOT_ALLOWED`, `LICENSE_EXPIRED`, `LICENSE_NOT_FOUND`, `FORBIDDEN`.
`409`	Çakışma. Olası kodlar: `CONFLICT`, `IDEMPOTENCY_CONFLICT`, `MEDIA_IN_USE`, `SOCIAL_APPROVAL_REQUIRED`, `SOCIAL_POST_NOT_EDITABLE`.
`422`	İşlenemeyen istek. Olası kodlar: `VALIDATION_FAILED`, `MESSAGING_WINDOW_CLOSED`, `CHANNEL_ACCOUNT_MISSING`, `CONTACT_BLOCKED`, `STORAGE_LIMIT_REACHED`, `SOCIAL_POST_INVALID`, `SOCIAL_PLATFORM_UNAVAILABLE`.
`429`	Hız sınırı aşıldı. Olası kodlar: `RATE_LIMITED`.
`500`	Sunucu hatası. Olası kodlar: `INTERNAL`.
`502`	Sağlayıcı hatası. Olası kodlar: `PROVIDER_ERROR`.

Örnek yanıt (200)


{
  "data": {
    "text": "مرحباً، تم استلام طلبكم.",
    "from": "tr",
    "to": "ar",
    "charged": "0.002000"
  }
}