Skip to main content
Cisco IP phones consume XML directly from these endpoints. No JWT authentication — sessions are PIN-based and MAC-tracked.

​
Main Directory Menu

GET /cisco/services/dir?mac=<MAC>
Returns a CiscoIPPhoneMenu with links to Personal Directory and Corporate Directory. Parameters
ParamDescription
macPhone MAC address (SEP prefix stripped)

​
Personal Directory

GET /cisco/services/pdir?mac=<MAC>
PIN-based authentication. Sessions expire after 24 hours.

​
Login

When no session exists, the phone shows a login form. Submit username + PIN.

​
Directory Listing

After login, returns a CiscoIPPhoneDirectory listing contacts. SoftKeys: Dial, Add, Options, Exit

​
Options Menu

OptionAction
Open ContactBrowse contacts and view profile
Reorder ContactsDrag-and-drop style reorder
Change PINCurrent PIN → New PIN → Confirm
LogoutDestroy session

​
Contact Profile

SoftKeys: Call (number picker), Edit, Delete, Exit Delete requires confirmation (Yes/No).

​
Add / Edit Contact

Fields: Name (required), Work, Mobile, Home, Email

​
Corporate Directory

GET /cisco/services/cdir
Read-only company-wide directory. No authentication required.

​
Directory Listing

Returns a CiscoIPPhoneDirectory with all contacts. SoftKeys: Dial, View, Exit

​
View Menu (Open Contacts)

Browse contacts as a menu. Select to view profile. Profile SoftKeys: Call (number picker), Back, Exit

​
Session Management

  • Sessions stored in MySQL cisco_sessions table
  • TTL: 24 hours from last activity
  • Each session tied to a phone MAC address
  • Logout destroys the session immediately