Magic Link REST API for Passwordless Login
The Magic Link API is Mideye Server’s REST interface for passwordless authentication. Send a phone number, and Mideye delivers a push notification (via the Mideye+ app) or an SMS magic link to the user’s phone. No username or password required.
Resources
Section titled “Resources”| Resource | Description |
|---|---|
| Magic Link API reference | Endpoints, request/response formats, error codes |
| Example applications | Ready-to-run code in Python, Java, C#, Go, and cURL/PowerShell |
| Keycloak integration | Add Mideye MFA to Keycloak via a custom authenticator SPI |
When to use the API vs RADIUS
Section titled “When to use the API vs RADIUS”| Use the Magic Link API when… | Use RADIUS when… |
|---|---|
| Building a custom login flow | Integrating a VPN, firewall, or network device |
| You want passwordless (phone-only) auth | The system already supports RADIUS |
| Integrating an identity provider (e.g., Keycloak) | Users authenticate with username + password + MFA |
| No username/password is available | Password validation against AD/LDAP is needed |
For RADIUS-based integrations, see RADIUS Integrations or Windows Integrations.
Quick start
Section titled “Quick start”- Configure a Magic Link endpoint in the Mideye web GUI
- Generate an API key for the endpoint
- Test with cURL or PowerShell — see example applications