ForHosting KIT · Strumenti per sviluppatori

Generatore di UUID

Un UUID è un identificatore univoco a 128 bit che distingue in modo sicuro record, file e richieste senza rischio di collisioni. Questo strumento del KIT li genera nel browser, in formato v4 casuale o v7 ordinabile per data, uno alla volta o in blocco, pronti da copiare.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

v4 casuale o v7 ordinabile: quale scegliere

La v4 è puramente casuale: perfetta quando ti serve solo unicità e non t'importa dell'ordine. La v7, più recente, include un timestamp nei primi bit, quindi gli identificatori restano ordinabili per data di creazione. È un vantaggio grosso come chiave primaria, perché gli indici del database restano compatti e le query per intervallo temporale volano. Se stai progettando da zero e non sai quale usare, parti dalla v7.

Uno o mille in un colpo solo

Devi popolare una tabella di test o assegnare un identificatore a ogni riga di un import? Imposta quanti UUID vuoi e li generi tutti insieme, pronti da incollare in uno script SQL, in un file CSV o nel seed del gestionale. Nessun limite sul numero: il calcolo avviene sul tuo dispositivo, quindi generarne diecimila è istantaneo e non pesa su nessun server.

Restano sul tuo computer, sempre

Un UUID di per sé non è un dato sensibile, ma il principio del KIT vale comunque: la generazione avviene interamente nel browser, con il generatore crittografico del sistema. Niente viene inviato online, niente viene registrato. Chiudi la scheda e non resta traccia da nessuna parte. È lo stesso motivo per cui funziona anche offline, in aereo o dietro il firewall aziendale.

Nel codice, via API

Se ti serve generare UUID dentro un flusso automatico — un webhook che crea un record, un job notturno — puoi chiamare il KIT via API: costa $0.002 a richiesta, senza abbonamento. La web resta il modo più rapido per uno al volo; l'API è il canale per quando è una macchina a chiederli. In arrivo anche app e altri canali.

Casi d'uso

Chiavi primarie per il gestionale

Lo Studio Commercialista Bianchi di Bologna migra l'archivio clienti a un nuovo database: assegna a ogni scheda un UUID v7, così i record restano ordinabili per data di inserimento senza rivelare quanti clienti ci sono.

Idempotency key per i pagamenti

Rossi & Figli S.r.l. invia richieste di incasso a PayPal: a ogni tentativo allega un UUID come idempotency key, così una doppia chiamata non genera mai un doppio addebito.

Nomi file unici per gli upload

Un'app che riceve foto di scontrini rinomina ogni upload con un UUID: niente collisioni tra due file scontrino.jpg caricati nello stesso minuto.

Domande frequenti

Che differenza c'è tra UUID v4 e v7?

La v4 è casuale al 100%; la v7 incorpora un timestamp, quindi è ordinabile cronologicamente. Per una chiave primaria nuova conviene la v7; per un token usa e getta va benissimo la v4.

Gli UUID generati sono davvero univoci?

La probabilità di una collisione tra due UUID v4 è talmente bassa da essere trascurabile nella pratica: parliamo di miliardi di identificatori prima di doverci pensare. Usiamo il generatore crittografico del browser, non un semplice random.

C'è un limite a quanti posso generarne?

No. Nel browser è gratis e senza limiti: uno o diecimila, il calcolo resta sul tuo dispositivo.

I dati vengono inviati da qualche parte?

No. La generazione avviene interamente nel browser: niente lascia il dispositivo e niente viene registrato. Funziona anche offline.

Posso usarlo nel mio codice?

Sì, via API: $0.002 a richiesta, senza registrazione né abbonamento. Utile quando è un processo automatico a dover creare gli identificatori.

Posso averli senza trattini?

Il formato standard è con i trattini (8-4-4-4-12 cifre esadecimali). Puoi copiarli così e togliere i trattini con un replace, se il tuo sistema li preferisce compatti.

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/uuid

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/uuid \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/uuid", {
  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/uuid",
    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/uuid", 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/uuid", 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.uuid",
  "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.002

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.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser