ForHosting KIT · Verifiche e controlli

Verifica CAP

Questo strumento controlla che un codice di avviamento postale sia scritto nel formato corretto per il Paese giusto: per l’Italia, cinque cifre. Ti dice subito se il CAP è ben formato e ti evita l’errore di battitura che manda un pacco nel posto sbagliato o blocca un modulo. Gira nel browser, gratis e senza limiti.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Cosa controlla (e cosa no)

Verifica il formato: per l’Italia il CAP è di cinque cifre, e lo strumento segnala se ne mancano, se ce ne sono troppe o se si è infilata una lettera. Supporta anche i formati di altri Paesi, che seguono regole diverse. Attenzione a cosa significa “valido”: qui vuol dire “ha la forma giusta”, non “esiste ed è di quella città”. Per accoppiare CAP e comune con certezza serve la validazione dell’indirizzo completo, che è un altro strumento.

Il CAP italiano in due parole

Cinque cifre: le prime indicano la zona, le ultime affinano fino alla località o, nelle grandi città, alla zona di consegna. 20121 è un CAP di Milano, 00184 di Roma, 10121 di Torino, 40121 di Bologna. Alcune città hanno un CAP generico e molti CAP specifici per quartiere. Lo strumento non conosce la mappa completa dei CAP, ma garantisce che quello che scrivi rispetti la forma delle cinque cifre.

Quando ti serve

Nei form dove l’utente digita il CAP a mano: registrazioni, ordini, richieste di preventivo. Un controllo di formato immediato blocca il refuso sul nascere — le quattro cifre digitate per sbaglio, la lettera scappata dalla tastiera — prima che finisca in database. Vale anche per ripulire una lista di indirizzi importata: passare la colonna dei CAP intercetta le celle malformate prima che diventino un problema in fase di spedizione o di fatturazione.

Gratis nel browser

Il controllo gira sul tuo dispositivo: i CAP che scrivi non vengono inviati da nessuna parte, e puoi verificarne quanti vuoi senza limiti e senza registrazione. Per validare il formato dei CAP in automatico dentro un flusso — la convalida di un form lato server, per esempio — c’è la versione via API a $0.002 a richiesta, con lo stesso controllo.

Casi d'uso

Campo CAP di un form d’ordine

Un e-commerce vuole evitare che l’utente digiti un CAP a quattro cifre. Il controllo di formato avvisa subito se il codice non ha le cinque cifre attese, prima che l’ordine venga confermato.

Pulizia di una lista indirizzi

Chi importa una vecchia rubrica clienti in Excel passa la colonna dei CAP allo strumento e trova le celle con un codice malformato — un CAP con una lettera, uno troppo corto — da sistemare prima di usare la lista.

Modulo di iscrizione a un evento

Un’associazione di Torino raccoglie iscrizioni online. Validare il CAP al momento della compilazione tiene l’anagrafica pulita ed evita solleciti per dati incompleti.

Domande frequenti

“CAP valido” vuol dire che esiste per quella città?

No. Questo strumento controlla il formato — per l’Italia, cinque cifre — non l’abbinamento con un comune preciso. Un CAP può avere la forma giusta e non corrispondere alla città indicata. Per verificare la coerenza tra CAP e comune serve la validazione dell’indirizzo completo.

Funziona solo con i CAP italiani?

No, riconosce anche i formati di altri Paesi, che hanno regole diverse dalle cinque cifre italiane. Indichi il Paese e lo strumento applica la forma attesa per quella nazione.

I dati che inserisco escono dal mio dispositivo?

No. Il controllo gira nel browser: i CAP restano sul tuo dispositivo, gratis, senza limiti e senza registrazione. Solo se usi la versione via API il dato viene elaborato sui nostri server e non conservato.

Posso controllare tanti CAP insieme?

Nel browser verifichi un codice alla volta, gratis e senza limiti di quantità. Per validare in automatico i CAP di una lista o di un form conviene l’API, a $0.002 a richiesta.

Riconosce i CAP con formati speciali, tipo le grandi città?

Sì: purché rispetti le cinque cifre, un CAP specifico di quartiere di Milano o Roma passa il controllo di formato. Lo strumento verifica la forma, non a quale zona corrisponde.

Serve registrarsi?

No. Nel browser è gratis e senza account. Con l’API paghi a consumo, con acquisto diretto e senza abbonamento.

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/postal-code

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/postal-code \
  -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/postal-code", {
  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/postal-code",
    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/postal-code", 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/postal-code", 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.postal_code",
  "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