Crear una invitación de calendario
Una invitación de calendario que se ve perfecta en un cliente y arruina la zona horaria en otro no es un error raro: es el resultado normal de escribir texto .ics a mano. Este endpoint toma los detalles de un evento en formato estructurado y devuelve un archivo correcto según el estándar, que cualquier aplicación de calendario importante puede leer sin problemas.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
La invitación que nadie quiere depurar
Confirmaciones de reserva, recordatorios de webinar, sistemas de citas y plataformas de cursos terminan necesitando entregarle al usuario un archivo que pueda agregar a su propio calendario. La tentación es armar un bloque VEVENT a mano, y funciona hasta que un evento recurrente cruza un cambio de horario de verano, o un invitado abre el archivo en un cliente estricto con el plegado de líneas y lo rechaza por completo. dev.ical existe para que el archivo que sale de su sistema sea correcto desde el diseño, no correcto hasta el próximo caso límite.
Qué envía usted y qué recibe de vuelta
Envíe POST a /dev/ical con el título del evento, hora de inicio y fin, zona horaria, ubicación, descripción y cualquier invitado o regla de recurrencia, y la llamada devuelve un task_id de inmediato. El archivo .ics terminado se entrega mediante una llamada de webhook firmada o queda disponible en un enlace firmado válido por 24 horas, así que encaja tanto en un sistema de reservas por colas como en un correo de confirmación puntual enviado justo después del pago.
Por qué el formato es más estricto de lo que parece
El formato iCalendar, definido en el RFC 5545, ha sido el idioma común entre programas de calendario desde finales de los años noventa, y surgió a partir del estándar anterior vCalendar para que una invitación creada en un sistema sobreviviera al abrirse en otro. Sus reglas sobre identificadores de zona horaria, plegado de línea cada 75 octetos y escape de comas y punto y coma dentro de campos de texto son exactamente las partes que los desarrolladores fallan al escribir .ics a mano, y las mismas partes que hacen que un archivo rebote en Outlook mientras se ve normal en un editor de texto. Generarlo de forma programática elimina esa categoría de error por completo.
Cómo encaja en un flujo más amplio de reservas o recordatorios
Como la tarea es asíncrona y se cobra por solicitud, una plataforma de citas puede generar una invitación en el instante en que se confirma una reserva, una herramienta de webinar puede producir una por cada persona inscrita sin frenar el flujo de registro, y un sistema de recordatorios recurrentes puede regenerar invitaciones actualizadas cada vez que cambia un horario, todo sin que alguien vigile el proceso. El resultado es solo un archivo: se adjunta a un correo, se sirve desde un enlace de descarga o se entrega directamente al sistema que dispara el envío, y la aplicación de calendario del otro lado hace el resto correctamente.
Qué puede hacer con ella
Correos de confirmación de reserva
Una aplicación de citas genera un adjunto .ics en el momento en que el cliente confirma un horario, para que la cita quede directamente en su calendario.
Registro de webinars y eventos
Una plataforma de webinars crea una invitación personalizada por cada inscrito, con la conversión de zona horaria correcta según la ubicación de cada asistente.
Recordatorios de clases recurrentes
Una plataforma de cursos en línea genera un archivo .ics de evento recurrente para que los estudiantes tengan una sola entrada de calendario que se repite cada semana, en vez de una invitación nueva por sesión.
Avisos de vencimiento o renovación
Un sistema de facturación SaaS emite una invitación de calendario para la fecha de renovación de una suscripción, así el cliente la ve junto a sus demás compromisos.
Preguntas frecuentes
¿Cómo genero un archivo .ics con la API?
Envíe los detalles del evento por POST a /dev/ical, guarde el task_id devuelto y reciba el archivo .ics terminado por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para generar iCal?
No, no hay plan gratuito ni prueba; cuesta $0.002 por solicitud, y una generación fallida nunca se cobra.
¿Qué aplicaciones de calendario abrirán el archivo?
El resultado sigue el RFC 5545, el formato iCalendar estándar compatible con Google Calendar, Outlook, Apple Calendar y prácticamente cualquier otro cliente de calendario importante.
¿Soporta eventos recurrentes?
Sí, puede indicar una regla de recurrencia y el archivo generado la codifica correctamente para que las aplicaciones de calendario la expandan en ocurrencias repetidas.
¿Maneja bien las zonas horarias?
Sí, los identificadores de zona horaria se codifican según el estándar, así que cada asistente ve la hora local correcta y no un desfase UTC sin contexto.
¿Puedo generar muchas invitaciones por lote?
Sí, envíe una tarea asíncrona por evento y reciba cada archivo .ics por webhook a medida que se complete, lo cual funciona bien para sistemas de registro con muchos asistentes.
¿Ya está disponible este endpoint?
Sí, /dev/ical está activo y aceptando solicitudes ahora mismo.
¿Se guardan los datos del evento después de generar el archivo?
No, los datos del evento y el archivo generado se eliminan después del período de retención y nunca se usan para entrenamiento.
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/ical \
-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/ical", {
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/ical",
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/ical", 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/ical", 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.ical",
"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. |