MOR API spy call
From Kolmisoft Wiki
Revision as of 07:29, 12 October 2023 by Dmitrij (talk | contribs) (Created page with "<!---This functionality is available from MOR x17---> =Description= Starts Spy call <br><br> =Usage= * From '''MOR X17''' call: '''/api/spy_call''' * Methods: POST, GET(if allowed, not recomended) <br><br> ===Parameters=== Parameters which are '''included''' into hash: * u - username for authentication. '''Required''' * active_call_id- active calls id. Can be retrieved using active_calls_get API. '''Required''' '''Note that parameters are shown in the same order a...")
Description
Starts Spy call
Usage
- From MOR X17 call: /api/spy_call
- Methods: POST, GET(if allowed, not recomended)
Parameters
Parameters which are included into hash:
- u - username for authentication. Required
- active_call_id- active calls id. Can be retrieved using active_calls_get API. Required
Note that parameters are shown in the same order as they have to be when generating the hash. Last parameter in a row is API_Secret_Key
Parameters which are not included into hash:
Request
If you want to initiate a spy call to an active calls with ID 1, you send:
You send:
HTML POST: http://<SERVER_IP>/billing/api/spy_call?u=admin&active_call_id=1&hash=df2983700ffecb52e6649f0cb3981b66537083a4
Returns
Spy call initiated: Everything is ok. Spy call initiated.
</page> <page> <status> <success>Spy call initiated</success> <spy_device>IAX/1002</spy_device> <channel>SIP/10.219.62.200-c40daf10</channel> </status> </page>
Errors:
- Chanspy is disabled
- Active call was not found
- No Spy Device assigned. Select it under User edit preferences.
- Cannot connect to Asterisk Server
- Spy Device is registered on different Server than this Call. Spying on this Call is not possible.
- Unable to spy virtual device
- You are not authorized to use this functionality
- Access denied
Example:
<page> <status> <error> No Spy Device assigned. Select it under User edit preferences. </error> </status> </page>