The ACI API allows custom-built applications to access Micro Focus ACI servers using the following HTTP action syntax to post the body to host:port.
action=actionparameter1=parameter_value
parameter2=parameter_value
is a CRLF combination or a CR.
where,
host
|
is the IP address (or name) of the machine on which the Micro Focus ACI server is running. |
port
|
is the port number that is used to send actions to the Micro Focus ACI server. |
action
|
is the action that you want the Micro Focus ACI server to run. |
parameterN
|
is the name of a required or optional parameter for the action. |
parameter_value
|
is the associated parameter value. |
Consider the following example that posts the following body to localhost:4000:
action=query querytext=dinosaurs maxresults=1
This action sends the query text dinosaur to an Micro Focus ACI server (in this case an IDOL server), which in response returns an XML result, for example:
<?xml version="1.0" encoding="UTF-8" ?>
<autnresponse>
<action>QUERY</action>
<response>SUCCESS</response>
<responsedata>
<autn:numhits>1</autn:numhits>
<autn:hit>
<autn:reference>
http://c.moreover.com/click/here.pl?z16358245&z=28
</autn:reference>
<autn:id>101927</autn:id>
<autn:section>0</autn:section>
<weight>97</weight>
<links>DINOSAUR</links>
<database>0</database>
<autn:title>Studying dinosaurs</autn:title>
</autn:hit>
</responsedata>
</autnresponse>
|
|