Trouver les formats de fichiers et les langues pris en charge via l'API

Utilisez ces points de terminaison d'API pour découvrir quels formats de fichiers sources et langues cibles votre projet prend en charge avant de créer des tâches de traduction.

À l'aide de ces points de terminaison, vous pouvez interroger :

Les langues cibles disponibles pour votre projet (avec les codes ISO)
Les formats de fichiers sources que vous pouvez téléverser, ainsi que tous les formats de fichiers de sortie supplémentaires que PTC peut générer pour ces fichiers

Tous les points de terminaison nécessitent un jeton d'API valide :

Authorization: Bearer YOUR_API_TOKEN

Liens rapides de l'API

Lister toutes les langues cibles
Lister les formats de fichiers pris en charge

Lister toutes les langues cibles

Récupère la liste des langues dans lesquelles votre projet peut être traduit. Vous pouvez également utiliser ce point de terminaison pour obtenir les codes ISO corrects lors de la création de tâches de traduction de contenu.

Requête HTTP

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

Paramètres

Ce point de terminaison n'accepte aucun paramètre.

Réponses

Réponse de succès

200 OKapplication/json

{
  "languages": [
    {
      "id": 123,
      "iso": "es",
      "name": "Spanish"
    },
    {
      "id": 124,
      "iso": "fr",
      "name": "French"
    },
    {
      "id": 125,
      "iso": "de",
      "name": "German"
    }
  ]
}

Schéma de réponse

Champ	Type	Description
`languages`	tableau[objet]	Le tableau d'objets de langues cibles configurées pour ce projet.
`languages[].id`	entier	L'identifiant unique de la langue.
`languages[].iso`	chaîne	Le code de langue ISO 639-1 (par ex., `en`, `es`, `fr`).
`languages[].name`	chaîne	Le nom de la langue lisible par un humain.

Réponses d'erreur

Non autorisé

401 Unauthorized

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

Interdit

403 Forbidden

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

Exemples de requêtes

Requête de base :

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

Exemples de code

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})`);
});

Lister les formats de fichiers pris en charge

Récupère toutes les extensions de fichiers sources que vous pouvez téléverser sur PTC, ainsi que tous les fichiers de traduction supplémentaires que PTC peut générer pour ces entrées.

Requête HTTP

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

Paramètres

Ce point de terminaison n'accepte aucun paramètre.

Réponses

Réponse de succès

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": []
    }
    //...
  ]
}

Schéma de réponse

Champ	Type	Description
`extensions`	tableau	Un tableau d'objets d'extensions de fichiers pris en charge.
`extensions[].extension`	chaîne	L'extension de fichier, sans le point.
`extensions[].additional_translation_files`	tableau	Un tableau de formats de fichiers de sortie supplémentaires disponibles pour ce type d'extension.

Fichiers de traduction supplémentaires

Certains types de fichiers peuvent générer des fichiers de traduction supplémentaires dans d'autres formats. Par exemple, les fichiers PO et POT peuvent produire :

mo – Des fichiers gettext compilés, utilisés par de nombreuses applications pour un chargement plus rapide
wp – Des fichiers de traduction JavaScript utilisés dans WordPress pour l'internationalisation côté client
php – Des fichiers de traduction stockés sous forme de tableaux PHP

Exemples de code

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);

Demander et récupérer des traductions via l'API →

Trouver les formats de fichiers et les langues pris en charge via l'API

Liens rapides de l'API

Lister toutes les langues cibles

Requête HTTP

Paramètres

Réponses

Réponse de succès

Schéma de réponse

Réponses d'erreur

Non autorisé

Interdit

Exemples de requêtes

Exemples de code

Lister les formats de fichiers pris en charge

Requête HTTP

Paramètres

Réponses

Réponse de succès

Schéma de réponse

Fichiers de traduction supplémentaires

Exemples de code

Suivant :