PTC

Unterstützte Dateiformate und Sprachen über die API finden

Verwenden Sie diese API-Endpunkte, um herauszufinden, welche Quelldateiformate und Zielsprachen Ihr Projekt unterstützt, bevor Sie Übersetzungsaufträge erstellen.

Mithilfe dieser Endpunkte können Sie abfragen:

  • Zielsprachen, die für Ihr Projekt verfügbar sind (mit ISO-Codes)
  • Quelldateiformate, die Sie hochladen können, sowie alle zusätzlichen Übersetzungs-Ausgabeformate, die PTC für diese Dateien generieren kann

Alle Endpunkte erfordern einen gültigen API-Token:

Authorization: Bearer YOUR_API_TOKEN

Alle Zielsprachen auflisten

Ruft die Liste der Sprachen ab, in die Ihr Projekt übersetzt werden kann. Sie können diesen Endpunkt auch verwenden, um die korrekten ISO-Codes beim Erstellen von Inhaltsübersetzungsaufträgen zu erhalten.

HTTP-Anfrage

GET https://app.ptc.wpml.org/api/v1/languages

Parameter

Dieser Endpunkt akzeptiert keine Parameter.

Antworten

Erfolgreiche Antwort

200 OKapplication/json
{
  "languages": [
    {
      "id": 123,
      "iso": "es",
      "name": "Spanish"
    },
    {
      "id": 124,
      "iso": "fr",
      "name": "French"
    },
    {
      "id": 125,
      "iso": "de",
      "name": "German"
    }
  ]
}
Antwortschema
Feld Typ Beschreibung
languages Array[Objekt] Das Array von Zielsprachenobjekten, die für dieses Projekt konfiguriert sind.
languages[].id Ganzzahl Der eindeutige Bezeichner für die Sprache.
languages[].iso Zeichenkette Der ISO 639-1 Sprachcode (z. B. en, es, fr).
languages[].name Zeichenkette Der menschenlesbare Name der Sprache.

Fehlerantworten

Nicht autorisiert
401 Unauthorized
{
  "error": "Unauthorized access. Please provide a valid API token."
}
Verboten
403 Forbidden
{
  "error": "Access denied. Insufficient permissions."
}

Beispielanfragen

Grundlegende Anfrage:

curl -X GET "https://app.ptc.wpml.org/api/v1/languages" \
  -H "Content-Type: application/json"

Codebeispiele

const response = await fetch('https://app.ptc.wpml.org/api/v1/languages', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log('Available target languages:', data.languages);

// Get language codes only
const languageCodes = data.languages.map(lang => lang.iso);
console.log('Language codes:', languageCodes);

Unterstützte Dateiformate auflisten

Ruft alle Quelldateierweiterungen ab, die Sie zu PTC hochladen können, zusammen mit allen zusätzlichen Übersetzungsdateien, die PTC für diese Eingaben generieren kann.

HTTP-Anfrage

GET https://app.ptc.wpml.org/api/v1/source_files/supported_extensions

Parameter

Dieser Endpunkt akzeptiert keine Parameter.

Antworten

Erfolgreiche Antwort

200 OKapplication/json
{
  "extensions": [
    {
      "extension": "po",
      "additional_translation_files": ["mo", "wp", "php"]
    },
    {
      "extension": "pot",
      "additional_translation_files": ["mo", "wp", "php"]
    },
    {
      "extension": "json",
      "additional_translation_files": []
    },
    {
      "extension": "yml",
      "additional_translation_files": []
    }
    //...
  ]
}
Antwortschema
Feld Typ Beschreibung
extensions array Ein Array von unterstützten Dateierweiterungsobjekten.
extensions[].extension Zeichenkette Die Dateierweiterung, ohne den Punkt.
extensions[].additional_translation_files array Ein Array zusätzlicher Ausgabeformate, die für diesen Erweiterungstyp verfügbar sind.
Zusätzliche Übersetzungsdateien

Einige Dateitypen können zusätzliche Übersetzungsdateien in anderen Formaten generieren. Zum Beispiel können PO– und POT-Dateien Folgendes erzeugen:

  • mo – Kompilierte Gettext-Dateien, die von vielen Anwendungen für schnelleres Laden verwendet werden
  • wp – JavaScript-Übersetzungsdateien, die in WordPress für die clientseitige Internationalisierung verwendet werden
  • php – Übersetzungsdateien, die als PHP-Arrays gespeichert sind

Codebeispiele

curl -X GET "https://app.ptc.wpml.org/api/v1/source_files/supported_extensions" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Weiter:

Übersetzungen über die API anfordern und abrufen →