ES
Iniciar sesión Solicitar demo
Desarrolladores

Una API REST pensada para datos multiinquilino

Veintitrés endpoints versionados bajo /api/v1. Autenticación Bearer, permisos acotados, límites por token y registro de auditoría en cada llamada.

Autenticación
# Genera un token en Panel → Integraciones.
# El secreto se muestra una sola vez y se guarda como hash SHA-256.

curl https://kourtiva.com/api/v1/me \
  -H "Authorization: Bearer $KOURTIVA_TOKEN"

# 401 si el token no es válido, ha caducado o se ha revocado.
# 403 si el token no tiene el permiso necesario.
# 429 cuando se supera el límite de peticiones.
api.kourtiva.com GET/v1/courts/availability Authorization: Bearer kv_live_•••• 200OK · 34ms { "venue": "vn_8832a", "courts": [ { "id": "crt_01", "sport": "padel", "free": ["19:00", "21:00"] }, { "id": "crt_02", "sport": "tennis", "free": ["18:00"] } ] }

Seguridad que no es opcional

  • Secretos guardados en hash: una filtración de base de datos no da ningún token usable
  • HTTPS obligatorio; el HTTP simple se rechaza en lugar de redirigirse
  • Permisos por token, así una integración de informes no puede escribir
  • Fechas de caducidad opcionales y revocación con efecto inmediato
  • El inquilino se resuelve en el servidor: nunca se acepta un ID de instalación del cliente
  • Se registran método, ruta, estado, duración y token en cada petición
Recursos

Qué puedes leer y escribir

Reservas

Lista, inspecciona y filtra reservas de tus pistas, incluido el estado de check-in.

Pistas y turnos

Definiciones de pistas y sus turnos reservables, con disponibilidad por fecha.

Deportes e instalaciones

Los deportes que ofreces y las instalaciones de cada sede.

Socios

Los jugadores registrados en tu instalación, con su historial de reservas.

Facturas y pagos

Registros financieros ligados a las reservas que los originaron.

Torneos

Competiciones, equipos inscritos y partidos.

Visitantes

Recuentos de afluencia y resúmenes para informes de ocupación.

Perfil de la instalación

El registro de tu propia instalación: el inquilino al que apunta el token.

Versionada, así las actualizaciones las programas tú

Todo vive bajo /api/v1. Los cambios incompatibles salen como una versión nueva en lugar de aparecer sin avisar en la que ya integraste.

Solicitar acceso a la API
Disponibilidad de pistas
GET /api/v1/courts/12/slots?date=2026-08-09

{
  "data": [
    { "starts_at": "08:00", "available": true  },
    { "starts_at": "09:00", "available": false },
    { "starts_at": "10:00", "available": true  }
  ]
}

¿Necesitas un endpoint que no tenemos?

Dinos con qué estás integrando y lo miraremos.

Solicitar demo Explorar funciones
Reserva una demo privada