Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fix the examples; Fix mandatory parameter names.

...

Detailed description of the API request elements:

URL parameterExample

Description

Requirements
actionaction=GetMarkersName of the HTTP API request.Mandatory
apiKeyapiKey=74c8eea0-50c6-40b2-9f3e-252ed501c3c8API key used to identify the application.Mandatory
tokentoken=09835e02-6c10-11e0-bb22-ba324924019bUnique identifier for authenticated sessions. After successful authentication, the API sends back a token, which has to be used for each request.Mandatory if authentication is configured for the given API key.
responseTyperesponseType=HTML

Defines the format of the response of the API request. The following valid values apply:

  • XML: the response is formatted and structured in XML, designed for applications
  • HTML: the response is in human readable format and formatted using standard HTML; it can be directly displayed in any browser.
  • TEXT: simple clear text based response
If the parameter is missing, it defaults to XML.
callID

cid

callID=a8343631-9f35-4a3a-83f0-9e81592339fbDefines the internal ID of the call.
Either the callID or either the number parameter is mandatory
Mandatory

Response

XML based response sample on success:

Info
iconfalse
<?xml version="1.0" encoding="UTF-8"?>
<VerbaApi>
<Response code="0" type="GetMarkers">
<verbamarker>
<name>Sale</name>
<start>16700</start>
<end>65400</end>
</verbamarker>
<verbamarker>
<name>Price</name>
<start>101000</start>
<end>145000</end>
</verbamarker>
</Response>
<VerbaApi>

 


XML based response sample on error:

Info
iconfalse

<?xml version="1.0" encoding="UTF-8"?>

<VerbaApi>

<Response code="2" type="GetMarkers">

<ErrorMessage description="Error">Call <ErrorMessage>Call cannot be found.</ErrorMessage>

</Response>

</VerbaApi>

...


HTML based response sample:

...

TEXT based response sample: 


Info
iconfalse
Markers
Name: Sale, Start: 16700 ms, End: 65400 ms
Name: Price, Start: 10100 ms, End: 145000 ms