Come creare un contatto vCard
Una vCard è un file standard che racchiude i dati di un contatto — nome, telefono, email, azienda — in un formato che qualsiasi telefono riconosce e salva in rubrica con un tap. Questo strumento del KIT compone il file a partire dai dati che inserisci, pronto da scaricare o condividere.
Esegui gratis nel browser
Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.
Cosa contiene, oltre al nome e al numero
Una vCard può includere anche l’azienda, il ruolo, l’indirizzo email, il sito web e persino la foto del contatto: tutto quello che normalmente scriveresti a mano in rubrica, riunito in un unico file. Il destinatario apre il file e il telefono propone subito di salvarlo come nuovo contatto, senza digitare nulla e senza rischiare errori di trascrizione su numeri o indirizzi.
Dove si usa davvero
Sul biglietto da visita digitale allegato a una firma email, in un codice QR da stampare su un badge da fiera, in un file da inviare via WhatsApp a fine riunione invece di dettare il numero a voce: in tutti questi casi la vCard evita l’errore di battitura e il fastidio di ricopiare a mano ogni singolo campo, uno per uno, sul telefono di chi la riceve.
Gratis nel browser
La composizione avviene nel browser, gratis e senza limiti: compili i campi, scarichi il file .vcf, fatto. Per generare vCard in blocco — ad esempio l’intero organigramma aziendale in un colpo solo — la stessa funzione è disponibile via API, a $0.002 a richiesta, comoda quando i contatti da creare sono decine o centinaia insieme e non uno per volta.
Casi d'uso
Biglietto da visita digitale
Marco Rossi, agente di commercio, allega alla firma della propria email la vCard con tutti i suoi recapiti, così ogni destinatario la salva in rubrica con un tap senza doverli ricopiare.
Badge per una fiera di settore
Tecnoedil Verona S.n.c. stampa sul badge dei propri commerciali un codice QR che contiene la vCard aziendale, pronta da salvare per chiunque scansioni allo stand.
Contatto condiviso a fine riunione
Giulia Bianchi invia via WhatsApp la vCard del nuovo referente subito dopo una riunione, invece di far ricopiare a mano numero ed email a tutti i partecipanti.
Domande frequenti
In che formato viene scaricato il file?
In formato .vcf, lo standard vCard riconosciuto da tutti i telefoni Android e iPhone e dai principali programmi di posta.
Posso includere una foto?
Sì, puoi allegare un’immagine che comparirà insieme al contatto una volta salvato in rubrica.
Quanto costa crearne una?
Nel browser è gratis e senza limiti, senza registrazione. Solo l’uso via API, per generarne in blocco, è a pagamento a $0.002 a richiesta.
Il file resta solo sul mio dispositivo prima di scaricarlo?
Sì, il file viene composto nel browser: i dati del contatto non vengono inviati a nessun server durante la creazione.
Posso creare tanti file insieme per un intero elenco?
Nel browser uno alla volta; per generarne in blocco da un elenco, usa la stessa funzione via API, a $0.002 a richiesta.
Funziona anche su iPhone?
Sì, il formato vCard è uno standard riconosciuto sia da iPhone sia da Android.
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
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/vcard \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/dev/vcard", {
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/dev/vcard",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/vcard", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"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/dev/vcard", 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": "dev.vcard",
"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
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. |