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 Übersetzungsjobs erstellen.

Über diese Endpunkte können Sie Folgendes abfragen:

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

Alle Endpunkte erfordern ein gültiges 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 zu erhalten, wenn Sie Inhaltsübersetzungsjobs erstellen.

HTTP-Anfrage

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

Parameter

Dieser Endpunkt akzeptiert keine Parameter.

Antworten

Erfolgsantwort

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[object]	Das Array der für dieses Projekt konfigurierten Zielsprachenobjekte.
`languages[].id`	integer	Die eindeutige Kennung für die Sprache.
`languages[].iso`	string	Der ISO-639-1-Sprachcode (z. B. `en`, `es`, `fr`).
`languages[].name`	string	Der menschenlesbare Name der Sprache.

Fehlerantworten

Nicht autorisiert

401 Unauthorized

{
  "error": "Unauthorized access. Please provide a valid API token."
}

Zugriff verweigert

403 Forbidden

{
  "error": "Access denied. Insufficient permissions."
}

Beispielanfragen

Einfache Anfrage:

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

Codebeispiele

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

require 'net/http'
require 'uri'

uri = URI('https://app.ptc.wpml.org/api/v1/languages')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
require 'json'
data = JSON.parse(response.body)
data['languages'].each { |lang| puts "- #{lang['name']} (#{lang['iso']})" }

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get('https://app.ptc.wpml.org/api/v1/languages', headers=headers)
data = response.json()
for language in data['languages']:
    print(f"- {language['name']} ({language['iso']})")

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://app.ptc.wpml.org/api/v1/languages',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
foreach ($data['languages'] as $language) {
    echo "- {$language['name']} ({$language['iso']})\n";
}
?>

import okhttp3.*;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
    .url("https://app.ptc.wpml.org/api/v1/languages")
    .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
    .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.ptc.wpml.org/api/v1/languages", nil)

    req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_API_TOKEN");

var response = await client.GetAsync("https://app.ptc.wpml.org/api/v1/languages");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);

const axios = require('axios');

const response = await axios.get('https://app.ptc.wpml.org/api/v1/languages', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

response.data.languages.forEach(lang => {
  console.log(`- ${lang.name} (${lang.iso})`);
});

Unterstützte Dateiformate auflisten

Ruft alle Quelldateiendungen ab, die Sie in die PTC hochladen können, zusammen mit allen zusätzlichen Übersetzungsdateien, die 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

Erfolgsantwort

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 Objekten für unterstützte Dateiendungen.
`extensions[].extension`	string	Die Dateiendung ohne Punkt.
`extensions[].additional_translation_files`	array	Ein Array von zusätzlichen Ausgabeformaten, die für diesen Endungstyp 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"

require 'net/http'
require 'uri'

uri = URI('https://app.ptc.wpml.org/api/v1/source_files/supported_extensions')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.get('https://app.ptc.wpml.org/api/v1/source_files/supported_extensions', headers=headers)
print(response.json())

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://app.ptc.wpml.org/api/v1/source_files/supported_extensions',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN'
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

print_r(json_decode($response, true));
?>

import okhttp3.*;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
    .url("https://app.ptc.wpml.org/api/v1/source_files/supported_extensions")
    .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
    .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.ptc.wpml.org/api/v1/source_files/supported_extensions", nil)

    req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

using System;
using System.Net.Http;
using System.Threading.Tasks;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_API_TOKEN");

var response = await client.GetAsync("https://app.ptc.wpml.org/api/v1/source_files/supported_extensions");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);

const axios = require('axios');

const response = await axios.get('https://app.ptc.wpml.org/api/v1/source_files/supported_extensions', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

console.log(response.data);

Weiter:

Übersetzungen über die API anfordern und abrufen →