API para Developers

Integra Control de Acceso en Tus Aplicaciones

API REST pura, sin SDKs propietarios. Usa el lenguaje que prefieras con fetch, axios, requests o curl. Sandbox gratuito y documentación completa.

// Abrir portón programáticamente
const response = await fetch('https://api.kofur.cl/v1/access/open', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    device_id: 'kofur_device_123',
    duration: 5 // segundos
  })
});

const data = await response.json();
console.log(data.status); // "opened"

Casos de Uso

Integra Kofur en tus aplicaciones para crear experiencias innovadoras

Apps de Gestión Inmobiliaria

Integra control de acceso directamente en tu plataforma de gestión de propiedades. Tus clientes abren portones desde tu app.

Ej: PropTech startup que gestiona 500+ condominios

Plataformas de Arriendo

Check-in automático para arriendos temporales. Genera códigos QR únicos por reserva que expiran automáticamente.

Ej: Airbnb Management con acceso temporal automatizado

Logística y Deliveries

Abre portones automáticamente cuando el repartidor se acerca. Integración con GPS y geofencing.

Ej: App de deliveries con acceso a condominios sin llamar

Sistemas de Reservas

Sincroniza reservas de espacios comunes con accesos temporales. Permisos automáticos basados en calendario.

Ej: Reserva de quincho = acceso automático en horario reservado

Plataformas de Seguridad

Integra control de acceso en sistemas de monitoreo y alarmas. Correlaciona eventos de apertura con cámaras.

Ej: Central de monitoreo con control total de accesos

Software de Administración

ERP para condominios con control de acceso integrado. Gestión completa de residentes, visitas y proveedores.

Ej: Software de administración con módulo de accesos

Características de la API

Todo lo que necesitas para construir aplicaciones robustas

REST API Completa

Endpoints para control de accesos, gestión de usuarios, logs de eventos, configuración de dispositivos y más.

Respuesta Rápida

Latencia promedio <100ms. Infraestructura optimizada para tiempo real. Uptime 99.9%.

Seguridad Robusta

OAuth 2.0, API Keys, rate limiting, encriptación end-to-end. Cumplimiento GDPR.

Sin SDKs Propietarios

HTTP REST estándar. Usa cualquier lenguaje, cualquier librería. No aprendas nuestra sintaxis, usa la que ya conoces.

Webhooks en Tiempo Real

Recibe notificaciones instantáneas de eventos: aperturas, intentos fallidos, baterías bajas, etc.

Analytics y Logs

Acceso completo a histórico de eventos, estadísticas de uso, reportes personalizables vía API.

Endpoints Principales

Referencia rápida de la API. Documentación completa en developers.kofur.cl

Control de Accesos

POST /v1/access/open

Abre un dispositivo específico por duración determinada. Requiere device_id y duration (segundos).

GET /v1/access/status/{device_id}

Obtiene el estado actual de un dispositivo (abierto/cerrado, batería, conectividad).

GET /v1/access/logs

Histórico de accesos con filtros por fecha, dispositivo, usuario. Paginado.

Gestión de Usuarios

POST /v1/users

Crea nuevo usuario con permisos de acceso. Soporta titulares, sub-usuarios y visitantes temporales.

PUT /v1/users/{user_id}

Actualiza información y permisos de usuario existente.

DELETE /v1/users/{user_id}

Elimina usuario y revoca todos sus accesos inmediatamente.

Configuración de Dispositivos

GET /v1/devices

Lista todos los dispositivos asociados a tu cuenta con estado y configuración.

PUT /v1/devices/{device_id}/settings

Actualiza configuración del dispositivo (nombre, duración apertura, sensibilidad).

Usa el Lenguaje que Prefieras

API REST estándar. No necesitas aprender librerías propietarias. HTTP requests simples.

Es Solo HTTP - Sin Complicaciones

No mantenemos SDKs. Nuestra API es REST puro. Usa fetch, axios, requests, curl, HttpClient o lo que sea. Si sabes hacer un POST request, sabes usar Kofur.

JavaScript

const response = await fetch(
  'https://api.kofur.cl/v1/access/open',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      device_id: 'kofur_123'
    })
  }
);

Python

import requests

response = requests.post(
  'https://api.kofur.cl/v1/access/open',
  headers={
    'Authorization': f'Bearer {API_KEY}'
  },
  json={'device_id': 'kofur_123'}
)

PHP

$ch = curl_init('https://api.kofur.cl/v1/access/open');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer $API_KEY"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, 
  json_encode(['device_id' => 'kofur_123'])
);
$response = curl_exec($ch);

cURL

curl -X POST \
  https://api.kofur.cl/v1/access/open \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"device_id":"kofur_123"}'

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.kofur.cl/v1/access/open"))
  .header("Authorization", "Bearer " + API_KEY)
  .POST("{\"device_id\":\"kofur_123\"}")
  .build();

Go

req, _ := http.NewRequest(
  "POST", 
  "https://api.kofur.cl/v1/access/open",
  bytes.NewBuffer(jsonData)
)
req.Header.Set("Authorization", "Bearer "+API_KEY)
resp, _ := client.Do(req)

¿Por qué no mantenemos SDKs?

Los SDKs requieren mantenimiento constante, testing en múltiples versiones, documentación duplicada y soporte complejo. Preferimos invertir ese tiempo en hacer la API más rápida, más estable y mejor documentada. Si sabes hacer HTTP requests (y todo desarrollador sabe), puedes usar Kofur en minutos.

Planes para Developers

Comienza gratis, escala cuando lo necesites

Sandbox

GRATIS

Para siempre

  • 1,000 requests/mes
  • 1 dispositivo de prueba
  • Documentación completa
  • Soporte por email
  • Todos los endpoints

Enterprise

Custom

Personalizado

  • Todo de Producción
  • On-premise disponible
  • SLA personalizado
  • Account manager dedicado
  • Desarrollo a medida
  • Consultoría técnica

Preguntas Frecuentes

Respuestas a consultas comunes sobre la API

El acceso al sandbox es instantáneo. Completas el formulario, recibes tu API key por email en menos de 5 minutos y puedes empezar a desarrollar inmediatamente. Para producción, revisamos tu aplicación y aprobamos en 24-48 horas hábiles.
No. El plan Sandbox incluye un dispositivo virtual que simula comportamiento real. Puedes probar todos los endpoints, recibir webhooks, ver logs, etc. Sin necesidad de hardware físico. Ideal para desarrollo y demos.
Cualquiera que haga HTTP requests. Es una API REST estándar (JSON sobre HTTP). Funciona con JavaScript, Python, PHP, Ruby, Go, Java, C#, Swift, Kotlin, y literalmente cualquier lenguaje moderno. No mantenemos SDKs propietarios - si sabes usar fetch(), axios, requests, curl o HttpClient, ya sabes usar Kofur. La documentación incluye ejemplos en los lenguajes más comunes.
Configuras una URL de tu servidor y nosotros enviamos POST requests cuando ocurren eventos (apertura, cierre, batería baja, error). Incluimos firma HMAC para validar autenticidad. Reintentamos automáticamente si tu servidor no responde. Disponible en plan Producción.
Sandbox: 1,000 requests/mes total. Producción: 100 requests/minuto por API key (144k/día). Enterprise: límites personalizados. Headers de respuesta incluyen X-RateLimit-Remaining para que monitorees tu uso. Si necesitas más, contacta ventas.
Absolutamente. Puedes cobrar por tu software que integra Kofur. No cobramos revenue share. Solo pagas por los dispositivos activos (0.5 UF/dispositivo/mes). Muchos de nuestros partners construyen SaaS sobre nuestra API y tienen modelos de negocio independientes.
Sandbox: soporte por email con respuesta en 48 horas. Producción: soporte prioritario con respuesta en 4 horas + acceso a Slack de developers. Enterprise: account manager dedicado, llamadas de soporte, y SLA personalizado. Todos tienen acceso a documentación completa y base de conocimientos.
Sí. Proyectos open source aprobados obtienen plan Producción gratuito para desarrollo y demos. Debes aplicar mostrando tu repo de GitHub, explicando el proyecto y su impacto en la comunidad. Evaluamos caso a caso. El objetivo es fomentar innovación.

Solicitar Acceso a la API

Completa el formulario y recibe tu API key en menos de 5 minutos