Crear una vCard
Un archivo de contacto que se abre bien en un teléfono pero desordena el campo del nombre en otro casi siempre significa que alguien construyó el texto de la vCard a mano en lugar de seguir la especificación al detalle. Esta api para generar vcard toma campos de contacto estructurados y devuelve un archivo .vcf correctamente formateado, para que cada dato quede en su lugar sin importar qué dispositivo o libreta de contactos lo importe.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Por qué una vCard hecha a mano se rompe tan fácil
El formato vCard parece simple, un puñado de líneas etiquetadas como FN, TEL y EMAIL, y precisamente por eso tantas implementaciones lo hacen mal de forma sutil: las reglas de plegado de línea, el escape de caracteres para comas y punto y coma dentro de un campo, y el orden específico que algunas aplicaciones de contactos esperan en silencio, todos hacen tropezar a un enfoque rápido de concatenación de texto. Un contacto que se importa perfecto en la libreta de un teléfono puede perder su campo de organización, desordenar un nombre con tilde, o descartar un número de teléfono por completo en otro, y la causa casi siempre es un detalle de la especificación que solo aparece cuando un dispositivo real analiza el archivo de forma estricta.
Qué recibe y qué produce POST /dev/vcard
Envía campos estructurados, nombre, números de teléfono, correos electrónicos, organización, cargo, dirección física y una referencia a una foto cuando aplique, y la tarea arma un archivo .vcf correctamente codificado siguiendo con exactitud las reglas de escape y plegado de línea del formato. El resultado se entrega por webhook firmado o por un enlace firmado válido por 24 horas, listo para adjuntar a un correo, servir como descarga, o codificar directamente en un código QR para una tarjeta de presentación digital.
Un formato anterior en una década al smartphone
La especificación vCard nació en 1995 como iniciativa del Versit Consortium, un grupo formado por varias empresas grandes de electrónica y software para estandarizar cómo se movían los datos de contacto personal entre dispositivos antes de que nadie llevara un teléfono en el bolsillo. Revisiones posteriores, incluida vCard 4.0 estandarizada en 2011, extendieron el formato para un mundo de dispositivos móviles y conjuntos de caracteres internacionales, pero el objetivo de fondo nunca cambió: un solo archivo que cualquier aplicación conforme al estándar pueda leer sin adivinar la intención de quien lo envió.
Dónde se usa realmente una vCard generada
Las tarjetas de presentación digitales codifican una vCard directamente en un código QR para que un saludo termine con un contacto guardado en lugar de una captura manual propensa a errores. Los sistemas de firma de correo adjuntan un archivo .vcf de forma automática para que quien lo reciba guarde los datos del remitente en un solo toque. Las exportaciones de CRM y los sistemas de registro de eventos que necesitan entregar a los asistentes un archivo de contacto descargable dependen de la misma corrección de fondo que exige un analizador estricto.
Cómo encaja en un flujo automatizado
Un sistema de alta que genera una vCard en el momento en que se crea la ficha de un empleado nuevo en el directorio, una plataforma de eventos que produce un archivo por cada asistente registrado, y un trabajo de exportación masiva que convierte toda una tabla de CRM en archivos de contacto individuales, todos llaman a este endpoint de la misma forma: envía los campos estructurados, recibe un task_id, y obtiene el .vcf terminado por webhook firmado o enlace. Generar una sola tarjeta de contacto o mil para una migración de directorio siguen exactamente el mismo camino asíncrono.
Qué puede hacer con ella
Tarjetas de presentación digitales vía código QR
Genere una vCard y codifíquela en un código QR para que al escanearlo se guarde un contacto completo y bien formateado en lugar de un texto suelto.
Adjuntos automáticos en firmas de correo
Adjunte un archivo .vcf generado a los correos salientes para que quien los reciba guarde los datos del remitente en un solo toque, correctamente en cualquier dispositivo.
Exportación de contactos en registro de eventos
Produzca un archivo de contacto descargable para cada asistente justo después de registrarse, listo para importar en su libreta de contactos.
Migración masiva de directorio
Convierta todo un directorio de empleados o clientes en archivos vCard individuales conformes al estándar, en un solo lote durante una migración de sistema.
Preguntas frecuentes
¿Qué devuelve exactamente esta api para generar vcard?
Un archivo .vcf correctamente formateado a partir de los campos estructurados que envía, codificado y con el escape aplicado según la especificación vCard, para que se importe sin errores en cualquier dispositivo conforme al estándar.
¿Qué versión de vCard genera?
La tarea genera una salida conforme al estándar ampliamente soportado, formateada para una importación confiable en teléfonos y aplicaciones de contactos actuales.
¿Puedo incluir una foto en la vCard?
Sí, una referencia a una foto puede incluirse como uno de los campos estructurados y se codifica en el archivo resultante según las reglas del formato.
¿Los caracteres especiales y los nombres con tilde se importan bien?
Sí, se aplica automáticamente el escape y la codificación de caracteres correctos, que es precisamente el detalle que rompe la mayoría de las vCard hechas a mano.
¿Puedo generar vCards en lote para una exportación de directorio?
Sí, como la tarea corre de forma asíncrona, todo un directorio o tabla de CRM puede convertirse en archivos individuales en un solo envío por lote.
¿Hay un plan gratuito para generar vCards?
La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.
¿Cuánto cuesta generar una vCard?
$0.002 por solicitud, y solo se cobra por las tareas que se completan con éxito.
¿Cómo recibo el archivo .vcf generado?
POST /dev/vcard devuelve un task_id de inmediato, y el archivo se entrega por webhook firmado o por un enlace firmado válido por 24 horas.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su 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)Ejemplo de solicitud
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.vcard",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |