Send a member from your own site or app to the HybridAF web access page, so they can get through the access steps and unlock a door from a phone browser without installing the HybridAF app. Authentication for the other API routes is described on the overview.
You build a link that carries one encoded value, key. The value identifies the facility and the member and says where the member is. The page does not ask the member to sign in. It reads the key, finds the facility and the member, and walks the member through the same steps the app shows.
userExternalId matches your ID for the member.The link needs no function key. The facility UID and the member's external ID in the key are what HybridAF checks.
Join five values with the pipe character, in this order, with no spaces, then encode the whole string as base64.
<facility-uid>|<user-external-id>|<latitude>|<longitude>|<utc-time> | Position | Value | Type | Description |
|---|---|---|---|
| 1 | Facility UID | GUID | The same facility UID you send as facilityUid on the facility users API. HybridAF support issues it for each facility you connect. |
| 2 | User external ID | string | The userExternalId you sent for this member through the facility users API. The member must already exist at the facility. |
| 3 | Latitude | number | The member’s current latitude in decimal degrees, with a period as the decimal separator. |
| 4 | Longitude | number | The member’s current longitude in decimal degrees, with a period as the decimal separator. |
| 5 | Current time | string | The time you built the link, in UTC, formatted yyyyMMddHHmmss on a 24-hour clock. |
HybridAF uses the coordinates to measure how far the member is from the facility's doors when the member asks to unlock. Send the member's actual position at the time you build the link.
Plain string:
3f2b8c1e-5d4a-4e7b-9c1d-0a6e2f7b8d41|MEMBER-1042|34.2257|-77.9447|20261112143005 Base64:
M2YyYjhjMWUtNWQ0YS00ZTdiLTljMWQtMGE2ZTJmN2I4ZDQxfE1FTUJFUi0xMDQyfDM0LjIyNTd8LTc3Ljk0NDd8MjAyNjExMTIxNDMwMDU= From a shell:
printf '%s' "<facility-uid>|<user-external-id>|<latitude>|<longitude>|$(date -u +%Y%m%d%H%M%S)" | base64 From Node.js:
const time = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
const plain = [facilityUid, userExternalId, latitude, longitude, time].join('|');
const key = Buffer.from(plain, 'utf8').toString('base64');
const link = 'https://app.hybridaf.com/Home/GuestAccess?key=' + encodeURIComponent(key); Append the encoded key to the access page address as the key query parameter. Base64 can contain +, / and =, so URL-encode it first. The example above becomes:
https://app.hybridaf.com/Home/GuestAccess?key=M2YyYjhjMWUtNWQ0YS00ZTdiLTljMWQtMGE2ZTJmN2I4ZDQxfE1FTUJFUi0xMDQyfDM0LjIyNTd8LTc3Ljk0NDd8MjAyNjExMTIxNDMwMDU%3D The address is https://app.hybridaf.com/Home/GuestAccess. Build a fresh link each time the member asks to unlock, so the position and time are current.
The link signs the member in and opens the facility page in the HybridAF web app. The page shows:
The facility's own settings decide what else appears. A member who has not accepted the facility's rules or waiver, or who does not pass the facility's access checks, sees a message explaining why in place of the door buttons. Where the facility allows it, the member can request emergency access. Admins at the facility see their admin doors.
userExternalId matches the second value in the key.When the key does not match a facility, or the member is not found at that facility, the page does not open a door. Check the facility UID and the external ID first, then contact support.
Questions about embedded access: contact HybridAF support or call 844-927-4313.