Consultar formatos de archivo e idiomas compatibles mediante la API

Utilice estos endpoints de la API para descubrir qué formatos de archivos de origen e idiomas de destino admite su proyecto antes de crear trabajos de traducción.

Al utilizar estos endpoints, puede consultar:

Idiomas de destino disponibles para su proyecto (con sus códigos ISO)
Formatos de archivos de origen que puede subir, además de cualquier formato de salida de traducción adicional que PTC pueda generar para esos archivos

Todos los endpoints requieren un token de API válido:

Authorization: Bearer YOUR_API_TOKEN

Listar todos los idiomas de destino

Recupera la lista de idiomas a los que se puede traducir su proyecto. También puede usar este endpoint para obtener los códigos ISO correctos al crear trabajos de traducción de contenido.

Solicitud HTTP

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

Parámetros

Este endpoint no acepta ningún parámetro.

Respuestas

Respuesta correcta

200 OKapplication/json

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

Esquema de la respuesta

Campo	Tipo	Descripción
`languages`	array[object]	Matriz de objetos de idioma de destino configurados para este proyecto.
`languages[].id`	integer	El identificador único del idioma.
`languages[].iso`	string	El código de idioma ISO 639-1 (por ejemplo, `en`, `es`, `fr`).
`languages[].name`	string	El nombre del idioma en formato legible por humanos.

Respuestas de error

Unauthorized

401 Unauthorized

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

Forbidden

403 Forbidden

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

Ejemplos de solicitud

Solicitud básica:

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

Ejemplos de código

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

Listar formatos de archivo compatibles

Recupera todas las extensiones de archivos de origen que puede subir a PTC, junto con cualquier archivo de traducción adicional que PTC pueda generar para esos archivos.

Solicitud HTTP

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

Parámetros

Este endpoint no acepta ningún parámetro.

Respuestas

Respuesta correcta

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

Esquema de la respuesta

Campo	Tipo	Descripción
`extensions`	array	Una matriz de objetos de extensión de archivo compatibles.
`extensions[].extension`	string	La extensión del archivo, sin el punto.
`extensions[].additional_translation_files`	array	Una matriz de formatos de salida adicionales disponibles para este tipo de extensión.

Archivos de traducción adicionales

Algunos tipos de archivo pueden generar archivos de traducción extra en otros formatos. Por ejemplo, los archivos PO y POT pueden producir:

mo: archivos gettext compilados, utilizados por muchas aplicaciones para una carga más rápida
wp: archivos de traducción de JavaScript utilizados en WordPress para la internacionalización del lado del cliente
php: archivos de traducción almacenados como matrices de PHP

Ejemplos de código

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

Solicitar y recuperar traducciones mediante la API →

Consultar formatos de archivo e idiomas compatibles mediante la API

Enlaces rápidos de la API

Listar todos los idiomas de destino

Solicitud HTTP

Parámetros

Respuestas

Respuesta correcta

Esquema de la respuesta

Respuestas de error

Unauthorized

Forbidden

Ejemplos de solicitud

Ejemplos de código

Listar formatos de archivo compatibles

Solicitud HTTP

Parámetros

Respuestas

Respuesta correcta

Esquema de la respuesta

Archivos de traducción adicionales

Ejemplos de código

Siguiente: