Als Entwickler registrieren und einen API-Schlüssel erhalten
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
Basis-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
- Fehlende erforderliche Parameter, ungültige Parameterformate oder Enum-Werte, fehlender Datei-Upload, Speicherfehler beim Upload oder Fehler bei der Aufgabenverarbeitung.
- 401 Unauthorized
- Fehlender API-Schlüssel oder ungültiger API-Schlüssel.
- 402 Payment Required
- Nicht genügend Guthaben für Vorschau, vollständige Übersetzung oder Textübersetzung.
- 404 Not Found
- Die Aufgabe oder das Glossar existiert nicht, wurde gelöscht, gehört nicht zum aktuellen API-Konto oder wurde nicht über die API erstellt.
- 409 Conflict
- Der aktuelle Aufgabenstatus erlaubt die angeforderte Operation nicht.
- 500 Internal Server Error
- Unerwartete Server-Ausnahme. Die Fehlerantwort lautet fest "Interner Serverfehler".
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.