Dokumentation der Übersetzungs-API
Authentifizierung, eine sichere erste Anfrage und der Auftragsablauf mit Beispielen für reines PHP. API v1 unterstützt je nach Kontoberechtigung Text, Dokumente und Audio.
https://api.translate24.pro/v1Zugang und Authentifizierung
Kontaktieren Sie uns, um Konto und Rechte zu vereinbaren. Native Konten verwenden ein ausgegebenes Bearer-Token. Diese Version bietet kein Dashboard zur selbstständigen Erstellung von Firmenschlüsseln. Kontakt aufnehmen
Authorization: Bearer YOUR_API_TOKENSpeichern Sie das Token in einer Umgebungsvariablen oder geschützten Serverkonfiguration. Verwenden Sie HTTPS. Zugangsdaten gehören nicht in URLs, Browser-JavaScript oder öffentliche Repositories.
Ein gespeicherter Passwort-Hash ist kein API-Passwort. Website-SSO und API-Authentifizierung sind getrennte Verfahren.
Erste Anfrage
Beginnen Sie mit dem Lesen Ihres Profils. Diese Anfrage erstellt keinen Auftrag und belastet kein Guthaben.
curl --request GET \
'https://api.translate24.pro/v1/user/view' \
--header "Authorization: Bearer $TRANSLATE24_API_TOKEN" \
--header 'Accept: application/json'Setzen Sie TRANSLATE24_API_TOKEN auf Ihrem Server. Prüfen Sie HTTP-Status und JSON: eine erfolgreiche Profilantwort enthält ein user-Objekt.
Lesen Sie die aktuellen Kataloge und verwenden Sie die zurückgegebenen IDs. Beispiel-IDs sind für Ihr Konto möglicherweise nicht verfügbar.
GET /languages/get-pairsGET /languages/get-themesGET /languages/get-typesGET /order/get-data-for-create-order
Reines PHP
Dieses lesende Beispiel verwendet die cURL-Erweiterung von PHP und benötigt kein Framework.
<?php
$token = getenv('TRANSLATE24_API_TOKEN');
if (!is_string($token) || $token === '') {
throw new RuntimeException('API token is not configured.');
}
$ch = curl_init('https://api.translate24.pro/v1/user/view');
if ($ch === false) {
throw new RuntimeException('Unable to initialize cURL.');
}
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Accept: application/json',
],
]);
$body = curl_exec($ch);
$httpStatus = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($body === false) {
// Keep diagnostic details in a protected server log.
throw new RuntimeException('API connection failed.');
}
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($httpStatus < 200 || $httpStatus >= 300) {
throw new RuntimeException('API HTTP error: ' . $httpStatus);
}
if (!is_array($data) || isset($data['errors'])
|| !isset($data['user']) || !is_array($data['user'])) {
throw new RuntimeException('Unexpected API response.');
}
$user = $data['user'];Speichern Sie Profildaten serverseitig und zeigen Sie nur benötigte Felder an. Das Beispiel gibt weder Kundendaten noch Zugangsdaten aus.
Auftragsablauf
- Wählen Sie Sprachpaar, Übersetzungsart und Thema aus den Katalogen. POST /order/create-as-draft erstellt einen Datensatz, ohne kostenpflichtige Arbeit automatisch zu starten.
- Prüfen Sie errors, order, price und infoMessage in der Antwort. Manche Dokumente erfordern eine manuelle Wortzählung.
- POST /order/in-work?id=ORDER_ID&pay_by=1 kann Guthaben abbuchen und die Arbeit starten. Holen Sie vorher eine ausdrückliche Freigabe ein.
- Verfolgen Sie den Fortschritt mit GET /order/view?id=ORDER_ID oder GET /order/index. Begrenzen Sie die Abfragehäufigkeit.
Felder für einen Auftragsentwurf
| Felder für einen Auftragsentwurf | Bedeutung |
|---|---|
type | 1: Text · 2: Dateien · 3: Audio |
source_type | 1: Textausgabe · 2: Audioausgabe |
language_pair_id | Katalog-ID oder from_language_code und to_language_code. |
translate_type_id | ID der Übersetzungsart aus dem Katalog |
translate_theme_id | Themen-ID aus dem Katalog |
source_text | Ausgangstext eines Textauftrags |
uploadSourceFiles[] | Datei- oder Audio-Uploads per Multipart |
user_id | Optional: ein vom angemeldeten Partner angelegter Kunde. Andernfalls gehört der Auftrag dem angemeldeten Konto. |
Senden Sie Text als Formularfelder, Dateien als multipart/form-data. Lassen Sie den HTTP-Client die Multipart-Grenze setzen.
Bei in-work verwendet pay_by=1 das Guthaben des angemeldeten Kontos; pay_by=2 das Guthaben des Auftragseigentümers und erfordert passende Partnerrechte und Kundenzuordnung.
Dateien und Audio
Dokumente: txt, odt, pdf, docx; bis zu 5 Dateien mit je 5 MiB. Audio: mp3, ogg, webm; bis zu 5 Dateien mit je 15 MiB.
Prüfen Sie jede Upload-Antwort. Eine Auftrags-ID allein ist keine Freigabe für kostenpflichtige Arbeit, wenn Verarbeitung oder Wortzählung fehlschlägt.
Fehler und Wiederholungen
401: Authentifizierung prüfen. 403: Rechte prüfen. 404: ID und Eigentümer prüfen. Eine 2xx-Antwort mit errors ist ein Anwendungsfehler; manche Validierungsfehler verwenden HTTP 200.
Nach einem Timeout oder 5xx kann ein Schreibvorgang bereits erfolgt sein. Prüfen Sie den Zustand vor einem erneuten Versuch. Wiederholen Sie Erstellung, Zahlung oder Löschung nicht automatisch: Es gibt keinen veröffentlichten Idempotenzschlüssel-Vertrag. Lesende Anfragen dürfen begrenzt und verzögert wiederholt werden.
Externe Konten
Externe Konten verwenden ihren vorgesehenen Basic-Authentifizierungsweg und dürfen nur das eigene Profil, die Übersetzungshistorie und erlaubte Kataloge lesen. Sie können keine Aufträge erstellen, starten oder löschen. Vereinbaren Sie für Schreibzugriff ein natives Integrations- oder Partnerkonto.
Endpunktreferenz
Die Pfade sind relativ zur Basis-URL. Der Zugriff hängt von den Kontorechten ab. Parameterschemata stehen in Swagger; kontaktieren Sie uns für die Freischaltung.
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /user/view | Ihr Profil |
| GET | /user/list | Partnerkunden |
| POST | /user/registration | Partnerkunden anlegen |
| POST | /user/delete | Partnerkunden löschen |
| GET | /order/index | Zugängliche Aufträge |
| GET | /order/view | Auftragsdetails |
| GET | /order/get-data-for-create-order | Auftragsoptionen |
| POST | /order/create-as-draft | Entwurf erstellen |
| POST | /order/in-work | Zahlung freigeben und Arbeit starten |
| POST | /order/delete | Löschbaren Auftrag entfernen |
| GET | /languages/get-pairs | Sprachpaare |
| GET | /languages/get-themes | Themen |
| GET | /languages/get-types | Übersetzungsarten |