Documentazione API

Traduci PDF in modo programmatico con la nostra semplice API REST. Ottieni una chiave API dalle impostazioni e inizia in pochi minuti.

Autenticazione

Invia la tua chiave API tramite l'header Authorization (Bearer token) o X-API-Key. Crea e gestisci le chiavi in Impostazioni → Chiavi API.

Endpoint

POST /api/v1/translate

https://translatepdfonline.com/api/v1/translate

Corpo della richiesta

{
  "document_id": "string (required)",
  "source_lang": "string (required) — en|zh|es|fr|it|el|ja|ko|de|ru",
  "target_lang": "string (required) — en|zh|es|fr|it|el|ja|ko|de|ru",
  "page_range": "string (optional) — e.g. '1-10' or '5'"
}

cURL

curl -X POST https://translatepdfonline.com/api/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "doc_xxx",
    "source_lang": "en",
    "target_lang": "zh",
    "page_range": "1-10"
  }'

Python

import requests

url = "https://translatepdfonline.com/api/v1/translate"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "document_id": "doc_xxx",
    "source_lang": "en",
    "target_lang": "zh",
    "page_range": "1-10"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())  # {"task_id": "...", "status": "queued"}

Node.js

const response = await fetch(
  "https://translatepdfonline.com/api/v1/translate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      document_id: "doc_xxx",
      source_lang: "en",
      target_lang: "zh",
      page_range: "1-10"
    })
  }
);

const data = await response.json();
console.log(data); // { task_id: "...", status: "queued" }

Limiti di richiesta

Ogni chiave API è limitata a 60 richieste al minuto. Gli header X-RateLimit-Limit e X-RateLimit-Remaining sono inclusi in ogni risposta.

Prezzi

La traduzione consuma 10 crediti per pagina. Controlla il saldo in Impostazioni → Crediti. Acquista crediti o attiva un abbonamento.

Domande frequenti

Come ottengo una chiave API per la traduzione PDF?

Registrati gratuitamente su translatepdfonline.com, vai su Impostazioni → Chiavi API e clicca su «Crea chiave». Copiala subito.

Quali lingue supporta l'API di traduzione?

L'API supporta 10 lingue: italiano, inglese, cinese, spagnolo, francese, greco, giapponese, coreano, tedesco e russo.

Quanto costa usare l'API?

Ogni pagina tradotta costa 10 crediti. I nuovi utenti ricevono crediti di prova gratuiti.

Come controllo lo stato della mia traduzione?

Dopo l'invio ricevi un task_id. Interroga GET /api/tasks/{task_id} per verificare lo stato (queued → processing → completed/failed).

L'API ha limiti di richiesta?

Sì, ogni chiave API è limitata a 60 richieste al minuto. Superato il limite riceverai una risposta 429.