X114

Riferimento API

Riferimento per ogni endpoint dell’API X114: autenticazione, schema richiesta, schema risposta e un esempio curl funzionante.

URL base

Tutti gli endpoint sono sotto lo stesso URL base. Usa HTTPS in produzione.

https://x114.org/api/v1

Autenticazione

Ogni richiesta richiede un token Bearer. Creane uno in Impostazioni → Chiavi API dopo la registrazione.

Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxx

Crediti

Ogni chiamata costa 1 credito. Saldo insufficiente restituisce 402. I crediti non scadono mai nel piano a vita.

Codici di stato

La stessa struttura è usata per ogni endpoint.

CodiceSignificato
401Chiave API mancante o non valida.
402Crediti insufficienti — ricarica dalla dashboard.
429Limite di velocità superato — attendi e riprova.
500Errore del server — sicuro riprovare con backoff.

Endpoint

echo1 credito

Echoes the JSON body back, with a server timestamp.

hash1 credito

SHA-1 / SHA-256 / SHA-384 / SHA-512 digest of a string.

json-validate1 credito

Validate and pretty-print JSON.

uuid1 credito

Generate 1-500 RFC-4122 v4 UUIDs.

qr-code1 credito

Generate a QR code as PNG, SVG, or UTF-8 blocks.

markdown-render1 credito

Render Markdown to HTML or plain text.