API
API open-tools
Accesso programmatico a tutti i nostri strumenti. Usalo per integrare lavori PDF o immagini in blocco nelle tue pipeline.
Avvio rapido
- Crea un account se non ne hai già uno.
- Crea una chiave API da Account → Chiavi API. Il token completo viene mostrato una volta sola; copialo ora.
- Passa il token come
Authorization: Bearer otk_…in ogni richiesta.
Riferimento
La specifica OpenAPI completa — ogni endpoint, ogni parametro, ogni forma di risposta — viene auto-generata dall'app FastAPI e servita come JSON. Sia Swagger UI che ReDoc la visualizzano.
Apri il riferimento API interattivo →Preferisci la specifica grezza o una console live? Il JSON OpenAPI leggibile da macchina e gli esplora Swagger / ReDoc sono disponibili per gli account che hanno effettuato l'accesso:
Esempio — dividere un PDF
Carica un file e interroga il risultato:
# 1. Upload and create the job
curl -X POST 'https://api.open-tools.app/api/upload' \
-H 'Authorization: Bearer otk_YOUR_KEY' \
-F 'file=@input.pdf' \
-F 'job_type=pdf-split' \
-F 'parameters={"pages": "1-3"}'
# → {"job_id": "abc123", "status": "queued", "ws_token": "..."}
# 2. Poll job status (or subscribe via WebSocket /ws/<job_id>?token=<ws_token>)
curl 'https://api.open-tools.app/api/jobs/abc123' \
-H 'Authorization: Bearer otk_YOUR_KEY'
# → {"status": "completed", "output_file_url": "https://api.open-tools.app/api/download/users/42/..."}
# 3. Download the result
curl -o output.pdf 'https://api.open-tools.app/api/download/users/42/<uuid>.pdf' \
-H 'Authorization: Bearer otk_YOUR_KEY'Codici di errore
Tutti gli errori condividono la stessa forma di envelope:
{
"detail": {
"error": {
"code": "INVALID_FILE_TYPE",
"message": "image-resize requires PNG, JPG, or WEBP.",
"details": { "expected_extensions": [".png", ".jpg", ".webp"] }
}
}
}| HTTP | Codice | Significato |
|---|---|---|
| 400 | INVALID_FILE_TYPE | Estensione file non nella lista consentita per questo lavoro. |
| 400 | INVALID_FILE_SIGNATURE | I magic byte non corrispondono all'estensione. |
| 400 | INVALID_PARAMETERS | Il parameters JSON non ha superato la validazione dello schema. |
| 401 | AUTH_REQUIRED | Nessun cookie di sessione o chiave API nella richiesta. |
| 403 | REAUTH_REQUIRED | Azione sensibile; sessione più vecchia di 15 min. |
| 413 | FILE_TOO_LARGE | Il caricamento supera il limite di 50 MB. |
| 429 | RATE_LIMITED | Finestra di livello superata. Vedi Retry-After. |
| 500 | INTERNAL_ERROR | Bug. Includi l'header request_id . |
Limiti di frequenza e utilizzo
Ogni account ha quote per minuto, ora, giorno e mese. L'utilizzo attuale è visibile su il tuo pannello account. Hai ricevuto un 429? Aspetta che la finestra scorra; la risposta includeRetry-After secondi.