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.

Basis-URLhttps://api.translate24.pro/v1

Zugang 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_TOKEN

Speichern 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
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-pairs
  • GET /languages/get-themes
  • GET /languages/get-types
  • GET /order/get-data-for-create-order

Reines PHP

Dieses lesende Beispiel verwendet die cURL-Erweiterung von PHP und benötigt kein Framework.

PHP
<?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

  1. Wählen Sie Sprachpaar, Übersetzungsart und Thema aus den Katalogen. POST /order/create-as-draft erstellt einen Datensatz, ohne kostenpflichtige Arbeit automatisch zu starten.
  2. Prüfen Sie errors, order, price und infoMessage in der Antwort. Manche Dokumente erfordern eine manuelle Wortzählung.
  3. 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.
  4. 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 AuftragsentwurfBedeutung
type1: Text · 2: Dateien · 3: Audio
source_type1: Textausgabe · 2: Audioausgabe
language_pair_idKatalog-ID oder from_language_code und to_language_code.
translate_type_idID der Übersetzungsart aus dem Katalog
translate_theme_idThemen-ID aus dem Katalog
source_textAusgangstext eines Textauftrags
uploadSourceFiles[]Datei- oder Audio-Uploads per Multipart
user_idOptional: 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.

MethodePfadZweck
GET/user/viewIhr Profil
GET/user/listPartnerkunden
POST/user/registrationPartnerkunden anlegen
POST/user/deletePartnerkunden löschen
GET/order/indexZugängliche Aufträge
GET/order/viewAuftragsdetails
GET/order/get-data-for-create-orderAuftragsoptionen
POST/order/create-as-draftEntwurf erstellen
POST/order/in-workZahlung freigeben und Arbeit starten
POST/order/deleteLöschbaren Auftrag entfernen
GET/languages/get-pairsSprachpaare
GET/languages/get-themesThemen
GET/languages/get-typesÜbersetzungsarten

Swagger ↗ · Kontakt aufnehmen