PTC

Trova i formati di file e le lingue supportate tramite le API

Usa questi endpoint API per scoprire quali formati dei file di origine e lingue di destinazione supporta il tuo progetto prima di creare job di traduzione.

Usando questi endpoint, puoi interrogare:

  • Le lingue di destinazione disponibili per il tuo progetto (con i codici ISO)
  • I formati dei file di origine che puoi caricare, oltre a eventuali formati di output di traduzione aggiuntivi che PTC può generare per quei file

Tutti gli endpoint richiedono un token API valido:

Authorization: Bearer YOUR_API_TOKEN

Elenca tutte le lingue di destinazione

Recupera l'elenco delle lingue in cui può essere tradotto il tuo progetto. Puoi usare questo endpoint anche per ottenere i codici ISO corretti quando crei job di traduzione dei contenuti.

Richiesta HTTP

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

Parametri

Questo endpoint non accetta alcun parametro.

Risposte

Risposta di successo

200 OKapplication/json
{
  "languages": [
    {
      "id": 123,
      "iso": "es",
      "name": "Spanish"
    },
    {
      "id": 124,
      "iso": "fr",
      "name": "French"
    },
    {
      "id": 125,
      "iso": "de",
      "name": "German"
    }
  ]
}
Schema della risposta
Campo Tipo Descrizione
languages array[object] L'array degli oggetti della lingua di destinazione configurati per questo progetto.
languages[].id integer L'identificatore univoco per la lingua.
languages[].iso string Il codice della lingua (ad es. en, es, fr). La maggior parte è in formato ISO 639-1, ma non tutti: l'elenco contiene anche tag secondari regionali e di sistema di scrittura come pt-BR, pt-PT e zh-Hans. Le maiuscole e minuscole sono significative: fai corrispondere i codici restituiti da questo endpoint invece di convertirli in minuscolo.
languages[].name string Il nome leggibile della lingua.

Il codice nel percorso di un file è una questione separata dal codice in questa risposta. Se output_file_path contiene {{lang}}, PTC sostituisce la mappatura della lingua configurata nel progetto per quella lingua, usando come fallback il codice di sistema quando non è impostata alcuna mappatura. Un progetto che mappa il tedesco a deutsch scrive deutsch nel percorso, mentre questo endpoint continua a restituire de, ed entrambi sono corretti.

Risposte di errore

Non autorizzato
401 Unauthorized
{
  "error": "Unauthorized access. Please provide a valid API token."
}
Accesso negato
403 Forbidden
{
  "error": "Access denied. Insufficient permissions."
}

Richieste di esempio

Richiesta di base:

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

Esempi di codice

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

Elenca i formati di file supportati

Recupera tutte le estensioni del file di origine che puoi caricare su PTC, insieme a eventuali file di traduzione aggiuntivi che PTC può generare per quegli input.

Richiesta HTTP

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

Parametri

Questo endpoint non accetta alcun parametro.

Risposte

Risposta di successo

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": []
    }
    //...
  ]
}
Schema della risposta
Campo Tipo Descrizione
extensions array Un array di oggetti per le estensioni dei file supportate.
extensions[].extension string L'estensione del file, senza il punto.
extensions[].additional_translation_files array Un array di formati di output aggiuntivi disponibili per questo tipo di estensione.
File di traduzione aggiuntivi

Alcuni tipi di file possono generare file di traduzione extra in altri formati. Ad esempio, i file PO e POT possono produrre:

  • mo – File gettext compilati, usati da molte applicazioni per un caricamento più rapido
  • wp – File di traduzione JavaScript usati in WordPress per l'internazionalizzazione lato client
  • php – File di traduzione archiviati come array PHP

Esempi di codice

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

Successivo:

Richiedi e recupera le traduzioni tramite le API →