Introducere
Oferă API-uri RESTful pentru traducerea documentelor, suportând gestionarea automatizată a sarcinilor de traducere, consistența terminologică bazată pe glosare și interogări pentru formatele, limbile și modelele suportate, facilitând construirea fluxurilor de lucru de traducere fără întreruperi și gestionarea conturilor de utilizator.
Primii pași
Pentru a începe, trebuie să aplici pentru a deveni dezvoltator.Aplică ca dezvoltator
Odată aprobat, puteți crea multiple chei API și include cheia API corespunzătoare în fiecare cerere API după cum este necesar.
Acces rapid
Base URL
https://otranslator.com/api
Mod de autentificare
Authorization: [yourSecretKey]
JSON cerere
Cu excepția interfeței de încărcare fișiere, interfețele folosesc implicit cereri POST JSON, Content-Type fiind application/json.
Încărcare fișier
Crearea sarcinii de traducere a documentelor folosește multipart/form-data, fișierul care urmează să fie tradus se transmite prin câmpul file.
Răspuns generic de eroare
Când cererea eșuează, interfața va returna JSON, câmpul error conține un mesaj de eroare fix în limba engleză. Se recomandă să prioritizați gestionarea erorilor pe baza codului de stare HTTP, câmpul error fiind utilizat pentru afișare sau înregistrarea în jurnale.
{
"error": "Invalid API key."
}Reguli pentru coduri de stare de eroare
Toate răspunsurile de eroare API v1 mențin aceeași structură, procesați conform regulilor următoare de cod de stare HTTP.
- 400 Bad Request
- Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
- 401 Unauthorized
- Missing API key or invalid API key.
- 402 Payment Required
- Insufficient credits balance for preview, full translation, or text translation.
- 404 Not Found
- The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
- 409 Conflict
- The current task status does not allow the requested operation.
- 500 Internal Server Error
- Unexpected server exception. The response error is fixed as "Internal server error.".
Flux de integrare recomandat
1. Creează sarcină
Încărcați fișierul și creați o sarcină de traducere, returnează taskId.
2. Verifică progresul
Interogați starea sarcinii până când aceasta devine Completed, Terminated sau Cancelled.
3. Obține rezultatul
Descărcați fișierul tradus sau citiți JSON-ul textului original și tradus.
4. Gestionează sarcini
Plătiți la cerere pentru traducere de text complet, repornirea sarcinii, revizuirea textului sau ștergerea sarcinii.