Difference between revisions of "MOR API recording update"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 9: Line 9:


Parameters which are '''included''' into hash:
Parameters which are '''included''' into hash:


* recording_id - ID of the recording. '''Required.'''
* recording_id - ID of the recording. '''Required.'''

Revision as of 16:15, 18 August 2021

Description

Updates comment for a specific recording id.

Usage

  • From MOR X16: /api/recording_update



Parameters

Parameters which are included into hash:

  • recording_id - ID of the recording. Required.
  • comment - comment for the recording. Optional.

Note that parameters are shown in the same order as they have to be when generating the hash. The last parameter in a row is API_Secret_Key

Parameters which are not included into hash:


Request

We have API Secret Key = secret We want to update recording id 82878881 with comment 12346

We send:

HTML POST:  http://<SERVER_IP>/billing/api/recording_update?u=admin&recording_id=82878881&comment=12346&hash=85ef4ad4eb5a582e07f07d9148a8faf8b9ce1cdd



Returns

Success: Everything is ok. The recording has been updated.


<?xml version="1.0" encoding="UTF-8"?>
<page>
  <status>
    <success>Recording was successfully updated</success>
  </status>
</page>

Errors:

  • <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
  • <error>Access Denied</error> - Such username does not exist in the database or it was not specified.
  • <error>Recording was not found</error> - Such Recording ID does not exist for a specified user.


See also