ForHosting KIT · Strumenti per sviluppatori

Genera lo schema JSON dal tuo file

Uno strumento che legge un file JSON reale — una risposta di un'API, un file di configurazione, l'export di un database — e ne ricava lo schema di validazione: tipi, campi obbligatori, formati. Utile a chi deve validare dati in ingresso senza scrivere la sintassi JSON Schema a mano.

● Stabileper richiesta + per documento$0.003

Esegui — $0.003 + $0.0135/documento Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

Incolla il JSON, non la sintassi che non ricordi

Lo schema JSON Schema ha una sintassi precisa — $ref, oneOf, patternProperties — che quasi nessuno scrive a memoria. Incolli qui il file di esempio, anche solo un oggetto con pochi campi, e il KIT restituisce lo schema completo: tipo di ogni campo, quali sono obbligatori, il formato di stringhe come date o email quando è riconoscibile. Lo schema esce pronto da salvare o incollare direttamente nel tuo validatore preferito, senza modifiche ulteriori.

Da più esempi, uno schema più solido

Se incolli più oggetti dello stesso tipo — per esempio dieci righe di un export — lo schema tiene conto delle differenze reali: un campo che in alcuni record manca diventa opzionale invece che obbligatorio per errore. È il modo più affidabile di dedurre uno schema quando i dati non seguono sempre esattamente la stessa forma, cosa che succede spesso con export reali di sistemi diversi.

A cosa serve davvero uno schema

Validare i dati che arrivano da un modulo web, da un webhook o da un fornitore esterno, prima che rompano il tuo codice a valle. Un campo che diventa null invece di un numero, una data in un formato diverso: lo schema li intercetta subito, con un errore chiaro invece di un crash tre passaggi dopo, quando ormai è più difficile capire da dove viene arrivato il problema.

Prezzo e come riceverlo

$0.003 a richiesta più $0.0135 a documento analizzato, senza abbonamento. Lo strumento gira dalla pagina web, dove incolli il file e leggi subito il risultato pronto da copiare; se lo richiami nel tuo flusso di lavoro, la stessa elaborazione è disponibile anche via API, allo stesso prezzo pubblicato, senza differenze di qualità e senza costi nascosti fra i due canali.

Casi d'uso

Validare l'export di un gestionale

Lo Studio Commercialista Bianchi riceve ogni mese un export JSON dal software di fatturazione di un cliente. Incollando un esempio ottiene lo schema una volta sola e lo riusa per controllare che ogni nuovo file abbia la stessa struttura, prima di importarlo.

Documentare un endpoint per il team

Un piccolo team che lavora per Tecnoedil Verona espone un endpoint interno e deve dare ai colleghi uno schema chiaro di cosa restituisce. Incollano una risposta reale e ottengono in un passaggio la documentazione tecnica da allegare al progetto.

Verificare i dati di un modulo prima di salvarli

Un modulo di contatto raccoglie nome, email e messaggio: prima di collegarlo al database, generare lo schema dall'esempio serve a capire subito quali campi trattare come obbligatori e quali come opzionali.

Domande frequenti

Funziona solo con JSON Schema o anche altri formati?

Oggi restituisce JSON Schema (il draft più diffuso), il formato che la maggior parte dei validatori — in Python, JavaScript, PHP — sa leggere direttamente.

Quanto costa davvero?

$0.003 a richiesta più $0.0135 a documento analizzato. Nessun abbonamento: paghi solo i file che elabori, a prezzo pubblicato.

Dove finisce il file JSON che incollo?

Viene elaborato per generare lo schema e poi eliminato: non lo conserviamo. Se contiene dati sensibili, valuta comunque cosa incolli, come con qualsiasi strumento online.

Riconosce i formati speciali, come email o data?

Sì, quando il valore è riconoscibile — una stringa nel formato di un'email o di una data ISO — lo schema lo segna con il formato corretto invece di lasciarlo come semplice stringa.

Posso dargli più esempi insieme?

Sì, ed è consigliato: più esempi dello stesso tipo di dato producono uno schema che distingue meglio i campi davvero obbligatori da quelli solo presenti per caso.

Posso usarlo dal telefono?

Sì, funziona dal browser del telefono. Per file JSON molto lunghi è più comodo lavorare da computer, ma per un esempio tipico va bene anche da mobile.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/dev/json-schema-gen

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/dev/json-schema-gen \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/json-schema-gen", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/json-schema-gen",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/json-schema-gen", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/json-schema-gen", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "input": "…"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.json_schema_gen",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.003

per documento$0.0135

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.
`422`	`task_failed`	L'attività non è andata a buon fine: non ti viene addebitato nulla.

Leggi la documentazione completa del KIT →