OpenKey API de Huayra SIGESE — ¿Existe un endpoint para links de invitación web?
Investigación hecha el 24-sep-2026 por pedido de Gabriel.
Resumen ejecutivo
No hay un endpoint público ni oculto para generar links de invitación web en la API v3 de
api.sigese.huayra.com.ar. El sistema de Huayra SIGESE no expone esa funcionalidad por API. Lo que
la app OpenKey Country hace al "compartir" una invitación es armar un mensaje de texto con los datos
del pase (nombre, DNI, fecha, número de autorización) y enviarlo por la sheet de compartir nativa de
Android/iOS (por WhatsApp, etc.) — no genera ningún link web ni URL pública.
Lo que analizamos
1. Scripts CLI (openkey.py)
El CLI de Plant (plant-openkey) habla con https://api.sigese.huayra.com.ar/api/v3 y tiene
implementados estos endpoints:
| Endpoint | Método | Qué hace |
|---|---|---|
/login | POST | Login (formato Plant Hub, con account_id) |
/auth/login | POST | Login (formato original, con pin) |
/booking/list | POST | Reservas vigentes del usuario |
/booking/amenities, /amenity/list, /amenities | GET | Listar amenidades reservables |
/booking/available, /booking/slots | POST | Horarios libres de una amenidad |
/booking/create, /booking/store, /booking/reserve | POST | Crear reserva |
/booking/{id}/cancel | POST/DELETE | Cancelar reserva |
/user/authorization/create | POST | Crear pase de acceso (invitación) |
/user/access_authorizations | GET | Listar autorizaciones vigentes en guardia |
2. Cliente de Plant Hub (openkey-client.ts)
El cliente TypeScript del Polo (iPark) implementa estos endpoints adicionales:
| Endpoint | Método | Qué hace |
|---|---|---|
/user/qrcredential | GET | QR dinámico del residente (HMAC SHA-256, 30s) |
/user/authorization/search_user | GET | Buscar DNI en el padrón |
/user/notifications | GET | Novedades de ingreso de guardia |
/user/authorization/{type}/{id} | DELETE | Revocar un pase activo |
3. La respuesta de /user/authorization/create
La respuesta del servidor al crear una invitación incluye data.id, y puede incluir data.qr_code
o data.qr. No incluye ningún campo link, url, share_url, public_url, web_link ni
similar. El código de Plant Hub arma un fallback OPENKEY:408:{id}:{dni} cuando no hay QR.
4. No hay documentación pública de la API
Huayra SIGESE es software propietario sin documentación pública de API. Lo que sabemos viene de
hacer ingeniería inversa de la app móvil OpenKey Country v3.16.102 (headers Cloudflare, slug,
channel, etc.) documentada en los scripts.
Qué se podría hacer (alternativas)
- Armar el link nosotros: Crear una página en
plantinterno.como un route en Plant Hub que
muestre los datos del pase (nombre, DNI, fecha, código QR si la API lo devuelve) con un UUID
firmado. El invitado recibiría ese link por WhatsApp y lo mostraría en la guardia.
- Hablar con OpenKey: Escribirle a
soporte@openkey.com.ar(empresa es de Axin SRL, Juan
Sentaus y Marina Taján) y preguntar si tienen una API de links compartidos o si hay una versión
web de la credencial. Es posible que lo tengan para algunos clientes premium y no esté en v3.
- Interceptar el tráfico de la app: Poner un proxy MITM (mitmproxy) en un teléfono y hacer el
flujo de "compartir invitación" para ver si la app le pega a algún endpoint que no hayamos
encontrado. Riesgo: la app podría tener cert pinning.
Endpoints que NO existen (probados o buscados sin resultado)
/user/authorization/share/user/authorization/{id}/link/invitation/link/share/link/public/access
Ninguno de estos aparece en el código, en la web ni en búsquedas públicas.
🔗 Conexiones Neuronales
Datos/openkey-api-link-web