Einführung
Bietet RESTful-APIs für Dokumentenübersetzung, unterstützt automatisierte Verwaltung von Übersetzungsaufgaben, glossarbasierte Terminologiekonsistenz und Abfragen für unterstützte Formate, Sprachen und Modelle, wodurch die Erstellung nahtloser Übersetzungsworkflows und die Verwaltung von Benutzerkonten vereinfacht wird.
Erste Schritte
Um zu beginnen, müssen Sie sich als Entwickler bewerben.Als Entwickler bewerben
Nach der Genehmigung können Sie mehrere API-Schlüssel erstellen und den jeweiligen API-Schlüssel bei Bedarf in jede API-Anfrage einbinden.
Schnellzugang
Base URL
https://otranslator.com/api
Authentifizierungsmethode
Authorization: [yourSecretKey]
JSON-Anfrage
Mit Ausnahme der Datei-Upload-Schnittstelle verwenden Schnittstellen standardmäßig POST JSON-Anfragen, Content-Type ist application/json.
Dateiupload
Das Erstellen einer Dokumentübersetzungsaufgabe verwendet multipart/form-data, wobei die zu übersetzende Datei im Feld file übergeben wird.
Allgemeine Fehlerantwort
Bei fehlgeschlagenen Anfragen gibt die Schnittstelle JSON zurück, wobei das Feld error eine festgelegte englische Fehlermeldung enthält. Es wird empfohlen, Fehler vorrangig nach HTTP-Statuscode zu behandeln, während das Feld error zur Anzeige oder Protokollierung verwendet wird.
{
"error": "Invalid API key."
}Fehlerstatuscode-Regeln
Alle v1 API-Fehlerantworten behalten die gleiche Struktur bei, bitte nach den folgenden HTTP-Statuscode-Regeln behandeln.
- 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.".
Empfohlener Ablauf zur Integration
1. Aufgabe erstellen
Datei hochladen und Übersetzungsaufgabe erstellen, gibt taskId zurück.
2. Fortschritt abfragen
Den Aufgabenstatus abfragen, bis Completed, Terminated oder Cancelled.
3. Ergebnis abrufen
Übersetzte Datei herunterladen oder Original- und Übersetzungs-JSON auslesen.
4. Aufgaben verwalten
Bedarfsgerechte Bezahlung für Volltextübersetzung, Neustarten von Aufgaben, Überarbeiten von Texten oder Löschen von Aufgaben.