Trimiterea unei cereri de traducere

Endpoint pentru trimiterea unei cereri de traducere

Acest endpoint permite trimiterea unei cereri de traducere către sistemul Ovesio. Poți trimite mai multe texte într-o singură cerere, fiecare cu propriile sale chei și contexte, iar traducerea poate fi realizată simultan în mai multe limbi.

URL endpoint

https://api.ovesio.com/v1/translate/request

Metodă

POST

Format date

application/json

Exemplu cerere JSON

{
  "from": "en",
  "to": ["fr", "de"],
  "conditions": {
    "de": "fr"
  },
  "use_existing_translation": true,
  "delta_mode": false,
  "workflow": 1,
  "callback_url": "https://example.com/api/callback",
  "data": [
    {
      "ref": "product-123",
      "content": [
        {
          "key": "title",
          "value": "Gaming Laptop ASUS ROG"
        },
        {
          "key": "description",
          "value": "High-performance laptop for gaming",
          "context": "Specificații produs"
        }
      ]
    }
  ]
}

Parametri cerere

Parametru Tip Obligatoriu Descriere
from string da Limba sursă. Dacă nu este cunoscută, se poate omite (AUTO).
delta_mode boolean nu Activează răspunsul tip callback doar dacă traducerea este diferită de precedentul.
workflow integer nu ID-ul fluxului de lucru dorit.
use_existing_translation boolean nu Dacă false, forțează retraducerea chiar dacă textul există deja în sistem.
to array da Limbi țintă (ex: ["fr", "de"]).
conditions object nu Permite definirea limbilor intermediare în traduceri în lanț (ex: {"de": "fr"}).
callback_url string nu URL-ul către care vor fi trimise rezultatele traducerii prin POST.
data array da Textele care urmează a fi traduse.


Structura câmpului data

Câmp Tip Obligatoriu Descriere
ref string nu Identificator unic (ex: ID produs, articol etc).
content array da Lista cu texte, fiecare cu propriul value și opțional key și context.


Structura câmpului content

Câmp Tip Obligatoriu Descriere
key string nu Eticheta textului (ex: title, description etc).
value string da Textul efectiv de tradus.
context string nu Context semantic pentru traducere (ex: “categorie produs”).


Răspunsuri posibile

Răspuns de succes (HTTP 200)

{
  "success": true,
  "data": [
    {
      "id": 320126,
      "ref": "product-123"
    }
  ]
}

Confirmă că cererea a fost acceptată și procesul de traducere a fost inițiat. Poți folosi id pentru a verifica statusul ulterior.

Răspuns de eroare (HTTP 400 sau alt cod ≠ 200)

{
  "success": false,
  "errors": {
    "invalid_data": "Invalid format detected"
  }
}

Această structură indică faptul că cererea a fost invalidă, iar câmpul errors va conține detalii specifice despre problema întâlnită.

Exemple de integrare

Poți consulta exemple de integrare disponibile pe pagina oficială de GitHub Ovesio.