| Document Center S-Series PBX Developer Remote Management
API Change Logs
When sending an API request, the request address must include the API version. All request samples in this guide use {api version} to represent the API version.
API Introduction
Yeastar S-Series VoIP PBX provides API interfaces for you to integrate a third-party software or device.
Communication Methods
Yeastar S-Series VoIP PBX communicates with the 3rd-party application server by two methods.
API Demo
Yeastar provides an API demo and sample configurations for you to test the API functions with Yeastar S-Series VoIP PBX.
Enable API Access on PBX
Before you start, enable API access on the PBX first.
Delete Blocked API IP
If an IP exceeds the allowed failed API login attempts, PBX will block the IP and tag the blocked IP as API-IP. You can delete the blocked API IP if the IP is trusted.
API Interfaces
References of API interfaces and API samples.
API Authentication
System
Extension
Trunk
IVR
Queue
Audio Calls
Play Prompts
Get Recording Files
Through this interface, you can get auto recording files of the PBX.
Send SMS Messages
Send SMS messages through a GSM/3G/4G trunk.
Hotel Wake-up Service
Hotel Check Out
Through this interface, you can perform checkout for the hotel customers.
Save and Apply Settings
By default, when you configure the PBX settings via API interfaces, the settings will be saved and applied automatically. To avoid that the changed settings not being applied, you can invoke this interface to apply all settings after all settings are configured.
System Report
The PBX will send report to the application server automatically when there is a change of system configuration or extension status, etc.
'System Startup' Report
'Changed Settings' Report
'Changed Extension Status' Report
The PBX will send a report to the application server when the extension status changes.
Call Report
The PBX will send call report to the application server automatically. Call event like call transfer, call failure, call released, etc. will be reported.
'Ringing' Report
'Ring Back' Report
The PBX will send a report to the application server when the called party (extension/inbound call) rings back the calling party.
'Answer a Call' Report
The PBX will send a report to the application server when an extension answers a call. Answering call (the called party) and call answered (the calling party) coexist. In the report, the calling party's number will appear first.
'Call Answered' Report
The PBX will send a report to the application server when the calling party's call is answered. Answering call (the called party) and call answered (the calling party) coexist. In the report, the calling party's number will appear first.
'Call Released' Report
The PBX will send two "BYE" reports to the 3rd-party application server when a call is released. In the first "BYE" report, the user who releases the call will appear first.
'Call Transfer' Report
When there is a call transferred inside the PBX, the PBX will send a report to the application server.
'Call Failure' Report
Generally, call failure event will appear in the response message of the API request. In certain circumstances, the PBX will send the report. Call failure is defined as calls that are failed to connect. Failure of calls initiated manually and by the API will both be reported.
'Keypress' Report
This event is used report key pressed (DTMF information) during a call.
CDR Report
CDR is raw data of all call activities. Records of all calls from the beginning to the end will be kept. When a call is released, the PBX will send a report to the application server in real time.
'Inbound Call Request' Report
If the trunk's API has Control Inbound Call Answering enabled, then whenever there's a call to this trunk, the PBX will send an INVITE event to the application server.
'Inbound Call' Report
If the trunk's API has Control Inbound Call Destination enabled, then when the trunk answers the call, the PBX will send an Incoming event to the application server.
'Prompt Play End' Report
Report the event when the prompt played to the extension and the external number ends.
'Customer Satisfaction Survey Result' Report
Once the DTMF pressed is collected from callers, API will send the customer satisfaction survey result to the client automatically.
Error Code
References of API error codes.