ForHosting KIT · Dati e file

Come creare un contatto vCard

Inserisca nome, telefono, email, azienda, ruolo, sito web e indirizzo e ottenga un file .vcf in vCard 3.0 con ogni dato al posto giusto, pronto da salvare su qualsiasi telefono o da inserire in un codice QR. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

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.

Perché una vCard scritta a mano si rompe

Il formato vCard sembra semplice, poche righe con un'etichetta come FN, TEL o EMAIL, ed è proprio per questo che tante implementazioni sbagliano nei dettagli. Le regole per spezzare le righe lunghe, i segni da proteggere quando una virgola o un punto e virgola compaiono dentro un dato e l'ordine che alcune rubriche si aspettano in silenzio mettono in difficoltà chi costruisce il testo a mano. Un contatto che si importa perfettamente su un telefono può perdere l'azienda, rovinare un nome accentato o perdere un numero su un altro. Questo generatore segue alla lettera le regole del formato, così ogni dato finisce al posto giusto su qualsiasi dispositivo.

Da dove viene e dove si usa

La vCard nasce nel 1995 da un'iniziativa del Versit Consortium, un gruppo di grandi aziende di elettronica e software che volevano un modo comune per far viaggiare i contatti tra dispositivi. Revisioni successive, come la vCard 4.0 del 2011, l'hanno estesa ai dispositivi mobili e agli alfabeti internazionali; questo strumento produce file vCard 3.0, in cui il nome completo è obbligatorio. Gli usi tipici sono i biglietti da visita digitali in un codice QR, il file allegato automaticamente alla firma delle email, il contatto da scaricare dopo l'iscrizione a un evento e la conversione di un'intera rubrica aziendale durante una migrazione.

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.

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.

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.

Funziona anche su iPhone?

Sì, il formato vCard è uno standard riconosciuto sia da iPhone sia da Android.

Strumenti correlati

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

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 '{"name":"Ada Lovelace"}'

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({
    "name": "Ada Lovelace"
  })
});
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={
    "name": "Ada Lovelace"
},
)
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" => '{"name":"Ada Lovelace"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"name":"Ada Lovelace"}`)
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

{
  "name": "Ada Lovelace"
}

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

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.

Note tecniche

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.

Domande tecniche

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.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser