Skip to main content

Device App User Authenticate

Authenticate device app users by validating their credentials.

Base URL: https://gate.zequenze.com/api/v1

Authentication: All endpoints require a Bearer token:

Authorization: Bearer <your-api-token>

Endpoints

POST /device_app_user_authenticate/

Validates user credentials for device app access and returns authentication status.

Parameters:

Parameter Type In Required Description
data string body Yes User credential data for authentication

Example Request:

POST /api/v1/device_app_user_authenticate/
Content-Type: application/json
Authorization: Bearer <your-api-token>

{
  "username": "john.doe",
  "password": "securePassword123",
  "device_id": "device_12345"
}

Example Response:

{
  "authenticated": true,
  "user_id": "user_67890",
  "username": "john.doe",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2024-01-15T14:30:00Z",
  "permissions": [
    "device_access",
    "app_usage"
  ]
}
Status Description
201 Authentication successful
400 Invalid credentials or malformed request
401 Unauthorized - invalid API token
429 Too many authentication attempts

Best Practices

  • Secure transmission: Always use HTTPS when transmitting credentials
  • Rate limiting: Implement client-side rate limiting to avoid hitting the 429 status
  • Token management: Store returned authentication tokens securely and refresh before expiration
  • Error handling: Handle authentication failures gracefully with appropriate user feedback
  • Device tracking: Include unique device identifiers to support device-specific authentication policies
Back to top