ForHosting KIT · Strumenti per sviluppatori

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.

● StabileGratis · nel tuo browser
Usalo da WebAPIEmailApp prestoTelegram presto

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.

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.

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.

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.

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.

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"]}'
{
  "items": [
    "valor-1",
    "valor-2"
  ]
}
{
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →