HTTP POST
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
NOTE:
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. |
Example:
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>