ForHosting KIT · Verifiche e controlli

Validazione indirizzo

La validazione indirizzo prende un indirizzo scritto alla buona e lo mette in ordine: separa via e numero civico, CAP, città e provincia, corregge i refusi più comuni e ti segnala se qualcosa non torna, come un CAP che non corrisponde alla città. Serve a chi spedisce, fattura o tiene un’anagrafica clienti e vuole indirizzi puliti.

● Betaper richiesta + per elemento$0.003

Esegui — $0.003 + $0.0135/elemento 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.

Da testo confuso a indirizzo in ordine

Gli indirizzi arrivano come capita: tutto su una riga, con abbreviazioni, senza provincia, con il CAP attaccato alla città. Lo strumento li interpreta e restituisce i campi separati e coerenti — via e civico, CAP a cinque cifre, comune, sigla della provincia — pronti da salvare in anagrafica o da stampare su un’etichetta. Riconosce le forme italiane: “Via”, “Viale”, “Piazza”, “Corso”, il civico con eventuale lettera, la provincia tra parentesi.

Gli errori che intercetta

Il CAP che non combacia con la città, la provincia sbagliata, il comune scritto con un refuso, il civico mancante. Sono gli errori che fanno tornare indietro un pacco o rimbalzare una fattura. Segnalarli prima della spedizione evita costi di riconsegna e clienti scontenti. Quando l’informazione è ambigua lo strumento propone la correzione più probabile, lasciando a te l’ultima parola: meglio un suggerimento da confermare che una modifica silenziosa e sbagliata.

Perché qui serve l’IA

Un indirizzo scritto da una persona non segue regole fisse: “v.le Roma 12 int.3 Milano” e “Viale Roma, 12 - 20121 Milano (MI)” sono lo stesso posto. Interpretare questa varietà è un lavoro da modello linguistico, non da semplice controllo di formato. Per questo la validazione indirizzo usa l’IA e si paga a consumo, mentre un controllo secco del solo CAP resta uno strumento a parte, gratis nel browser.

In beta, a consumo

Lo strumento è in beta e si esegue sul web o via API, a $0.003 a richiesta più $0.0135 per elemento, in dollari. Nessun abbonamento: paghi gli indirizzi che controlli. In beta può capitare che un indirizzo insolito — una frazione piccola, una via appena rinominata — venga interpretato male: verifica sempre le correzioni prima di usarle per una spedizione importante.

Casi d'uso

Anagrafica clienti di un e-commerce

Rossi & Figli S.r.l. importa gli indirizzi dai vecchi ordini, scritti in mille modi diversi. La validazione li mette in ordine — Via Garibaldi 8, 40121 Bologna (BO) — e segnala i CAP incoerenti prima di stampare le etichette.

Preparare le spedizioni

Prima di passare i pacchi al corriere, chi prepara le spedizioni fa controllare gli indirizzi: quelli con CAP e città che non combaciano vengono corretti subito, così i pacchi non tornano indietro con costi di riconsegna.

Dati di fatturazione

Uno studio deve fatturare a clienti con indirizzi raccolti al volo. Normalizzarli evita fatture con la provincia sbagliata e rende l’anagrafica coerente per gli anni successivi.

Domande frequenti

Che differenza c’è con la verifica del CAP?

La verifica del CAP controlla solo il codice postale a cinque cifre ed è gratis nel browser. La validazione indirizzo lavora sull’indirizzo completo — via, civico, città, provincia — lo interpreta, lo corregge e lo mette in ordine: un lavoro più complesso, che usa l’IA e si paga a consumo.

Riconosce gli indirizzi italiani con via, civico e provincia?

Sì, è pensato proprio per questo: separa la via dal civico (anche con lettera o interno), riconosce le forme come Viale, Piazza, Corso, il CAP a cinque cifre e la sigla della provincia. Restituisce i campi ordinati, pronti per l’anagrafica o l’etichetta.

Corregge da solo gli indirizzi sbagliati?

Propone la correzione più probabile e te la mostra, ma l’ultima parola è tua: non modifica in silenzio. Trattandosi di uno strumento in beta, conviene rivedere i suggerimenti prima di usarli per una spedizione che conta.

Quanto costa?

$0.003 a richiesta più $0.0135 per elemento, in dollari, a consumo. Nessun abbonamento: paghi gli indirizzi che controlli. Se ti serve la fattura, scrivici con i tuoi dati e la partita IVA.

Gli indirizzi che invio vengono conservati?

No. Vengono elaborati per la validazione e poi eliminati: non li archiviamo e non li usiamo per altro. Essendo uno strumento via API, il dato passa dai nostri server solo il tempo dell’analisi.

Verifica anche indirizzi esteri?

Se la spedizione è verso l’estero interpreta comunque i campi principali, ma è tarato soprattutto sugli indirizzi italiani, dove il riconoscimento di CAP, comuni e province è più affidabile.

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/verify/address

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/verify/address \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/verify/address", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/address",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/address", 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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.address",
  "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 elemento$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 →