Knowledge Discovery 25.1
Getting Started Guide

# Knowledge Discovery ACI Responses

Interactions with Knowledge Discovery components are structured according to the Autonomy Content Infrastructure (ACI) architecture. The ACI architecture defines how clients communicate with Knowledge Discovery components and how the components respond. In these interactions, clients submit ACI requests to Knowledge Discovery components as GET or POST HTTP requests, and receive ACI responses in the form of XML or JSON.

An ACI request consists of an ACI action and a collection of ACI parameters. See Send Actions to Knowledge Discovery.

For example, the following ACI request sends an action to a local Content component on port 9100. The action is `Query`, and there are two ACI parameters, `Text` with a value of `Content Component`, and `MaxResults` with a value of `20`.

    http://localhost:9100/action=Query&text=Content Component&MaxResults=20

The ACI action determines the collection of valid ACI parameters. For a given ACI action, some ACI parameters might be required while others are optional.

The ACI responses in XML use a uniform structure for the top two levels of the document tree. For example:

    <autnresponse xmlns:autn=”http://schemas.autonomy.com/aci/”>
       <action>QUERY</action>
       <response>SUCCESS</response>
       <responsedata>...</responsedata>
    </autnresponse>

Every ACI response returns the `<autnresponse>` node, defines the `autn` namespace as shown, and has three children of the document root:

`<action>` | contains the ACI action of the request.
`<response>` | contains either `SUCCESS` or `ERROR` indicating whether the ACI request succeeded or failed.
`<responsedata>` | contains the rest of the response, the structure of which depends on the ACI action.

Copyright 2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery 25.1

Topic Title: Knowledge Discovery ACI Responses