API Reference

Client

Authentication

class nexacon.auth.Auth(client)

Bases: object

Authentication service for external integration using nx_token

__init__(client)

generate_token(username: str, phone: str | None = None, email: str | None = None) → Dict[str, Any]

Generate nx_token for a user.

This endpoint requires API key and secret key (no nx_token needed). It will auto-register the user if they don’t exist.

Parameters:

• username – User identifier (phone number or email)

• phone – Optional phone number (defaults to username if starts with +)

• email – Optional email address

Returns:

Dictionary containing the generated nx_token

Raises:

• ValidationError – If username is not provided

• APIError – If token generation fails

verify_token() → Dict[str, Any]

Verify the current nx_token is valid.

Returns:

User information if token is valid

Raises:

• ValidationError – If no token is set

• AuthenticationError – If token is invalid

logout() → Dict[str, Any]

Logout the current session.

Returns:

Logout confirmation

get_user() → Dict[str, Any]

Get current user information.

Returns:

User information

Messaging

Calls

Devices

Rooms

Presence

Exceptions

Nexacon SDK Exception Classes

exception nexacon.exceptions.NexaconError

Bases: Exception

Base exception for all Nexacon SDK errors.

exception nexacon.exceptions.AuthenticationError

Bases: NexaconError

Raised when authentication fails.

exception nexacon.exceptions.APIError(message, status_code=None, response=None)

Bases: NexaconError

Raised when API request fails.

__init__(message, status_code=None, response=None)

exception nexacon.exceptions.RateLimitError(message, status_code=None, response=None)

Bases: APIError

Raised when rate limit is exceeded.

exception nexacon.exceptions.ValidationError

Bases: NexaconError

Raised when input validation fails.