Înregistrați-vă ca Dezvoltator și Obțineți o Cheie API
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
URL de bază
https://shangyiai.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
- Parametri obligatorii lipsă, formate de parametri sau valori enum invalide, fișier lipsă pentru încărcare, eșec la salvarea încărcării sau eșec la procesarea sarcinii.
- 401 Unauthorized
- Cheie API lipsă sau cheie API invalidă.
- 402 Payment Required
- Sold de credite insuficient pentru previzualizare, traducere completă sau traducere text.
- 404 Not Found
- Sarcina sau glosarul nu există, a fost șters, nu aparține contului API curent sau nu a fost creat prin API.
- 409 Conflict
- Starea actuală a sarcinii nu permite operațiunea solicitată.
- 500 Internal Server Error
- Excepție de server neașteptată. Eroarea de răspuns este definită ca "Eroare internă a serverului.".
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.