ConverterHQDevelopers
API v1

Fatturazione e utilizzo

Comprendi crediti, stime, sandbox, quote e riconciliazione dopo l’esecuzione.

ConverterHQ separa autorizzazione commerciale ed esecuzione tecnica. Il lavoro fatturabile riserva prima capacità e regola i crediti solo dopo un risultato certificato.

Sandbox senza crediti di produzione

Le chiavi hq_test_... di progetto usano limiti di valutazione e settlement a zero crediti. La sandbox non è un livello gratuito permanente di produzione.

Stimare prima di eseguire

Usa gli endpoint di stima quando il costo influenza la decisione. La stima resta indicativa perché tempo motore e percorso effettivo possono variare.

Riservare e regolare

Il worker riserva prima dell’esecuzione, regola dopo successo certificato e rilascia su errore, cancellazione o output invalido. Le conversioni fallite non consumano crediti. La quota mensile conta un Job di produzione accettato che contenga una conversione, inclusi REST, workflow, link firmati e MCP. Richieste di stato, caricamenti e Job sandbox non la consumano. Ripetere un invio con la stessa Idempotency-Key conta una volta. QUOTA_EXCEEDED impedisce l'avvio del lavoro. I Job accettati falliti o annullati continuano a contare; il rilascio dei crediti segue una politica separata. Consultare il contatore dell'account tramite GET /v1/commercial.

Riconciliare l’utilizzo

Usage API e HQTools sono le fonti commerciali. Conserva client_reference_id e request_id per collegare operazioni interne a Jobs, eventi d’uso e fatture.