Documentazione API Sviluppatori

API REST per Sviluppatori: Automazione PDF Aperta e Gratuita

Mentre altri servizi fanno pagare ogni singola conversione via API, raiai.cloud offre un’API REST unificata gratuita. Puoi automatizzare l’elaborazione di PDF, immagini e codici direttamente dal tuo software, script o server backend.

  POST https://raiai.cloud/wp-json/raiai/v1/process

Parametri principali della richiesta

Parametro	Tipo	Descrizione
`tool`	string (obbligatorio)	Lo slug dello strumento (es. `merge`, `compress`, `pdf2word`, `protect`, `qr`, `ocr`)
`files[]`	file / array	Uno o più file da elaborare (PDF, immagini o documenti Office)
`level`	string	Per compressione: `ebook`, `screen`, `printer`, `prepress`
`password`	string	Password per sbloccare o proteggere il documento
`text`	string	Testo per filigrana, firmatario, ricerca o generazione QR/Barcode

Esempi di integrazione pronti all’uso

1. cURL (Linea di comando)

curl -X POST https://raiai.cloud/wp-json/raiai/v1/process \
  -F "tool=compress" \
  -F "level=screen" \
  -F "files[]=@/percorso/al/tuo/documento.pdf" \
  --output documento_compresso.pdf

2. Python (Libreria requests)

import requests

url = "https://raiai.cloud/wp-json/raiai/v1/process"
payload = {"tool": "merge"}
files = [
    ("files[]", ("doc1.pdf", open("doc1.pdf", "rb"), "application/pdf")),
    ("files[]", ("doc2.pdf", open("doc2.pdf", "rb"), "application/pdf"))
]

response = requests.post(url, data=payload, files=files)

with open("unito.pdf", "wb") as f:
    f.write(response.content)

print("PDF unito con successo!")

3. JavaScript / Node.js (Fetch API)

const formData = new FormData();
formData.append('tool', 'qr');
formData.append('text', 'https://raiai.cloud');
formData.append('format', 'png');

fetch('https://raiai.cloud/wp-json/raiai/v1/process', {
  method: 'POST',
  body: formData
})
.then(res => res.blob())
.then(blob => {
  console.log('Codice QR generato, dimensione:', blob.size, 'byte');
});

Elenco completo degli strumenti disponibili via API

Puoi richiedere in qualsiasi momento l’elenco aggiornato in formato JSON chiamando:

GET https://raiai.cloud/wp-json/raiai/v1/tools