Skip to content

AX Semantics

The AX Semantics modules allow you to monitor, create, update, send, retrieve, list, and delete the documents from your AX Semantics account.

Getting Started with AX Semantics

Prerequisites

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting AX Semantics to Ibexa Connect

To connect your AX Semantics account to Ibexa Connect you need to obtain the Refresh Token from your AX Semantics account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your AX Semantics account.

  2. Click API Access.

    61f26690685d2.png

  3. Copy the Refresh Token to your clipboard.

    61f2669199428.png

  4. Log in to your Ibexa Connect account, add a module from the AX Semantics app into an Ibexa Connect scenario.

  5. Click Add next to the Connection field.

    61f2669307202.gif

  6. In the Connection name field, enter a name for the connection.

  7. In the Refresh Token field, enter the token details copied in step 3 and click Continue.

The connection has been established.

Triggers

Watch Generated Content

Triggers when new content is generated.

Webhook Name Enter a name for the webhook.

See the Setting Up AX Semantics Webhooks to add webhooks in your AX Semantics account.

Actions

Add a Document

Uploads your data.

Collection ID Select or map the Collection ID of the document.
Document Data Enter (map) the document data in the JSON format to publish the content in your collection. You can provide either a name and/or UID parameters that help to find your document easily.

Update a Document

Updates an existing document.

Collection ID Select or map the collection ID of the document which you want to update.
Document ID Select or map the Document ID whose details you want to update.
Document Data Enter (map) the document data in the JSON format to publish the content in your collection. You can provide either a name and/or UID parameters that help to find your document easily.

Get Details of a Document

Shows details of a document.

Collection ID Select or map the Collection ID whose document details you want to retrieve.
Document ID Select or map the Document ID whose details you want to retrieve.

Delete a Document

Deletes a document.

Collection ID Select or map the Collection ID whose document you want to delete.
Document ID Select or map the Document ID you want to delete.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.ax-semantics.com For example: /v3/documents/

For the list of available endpoints, refer to the AX Semantics API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Collections

The following API call returns all the collections from your AX Semantics account:

URL:

/v3/collections/

Method:

GET

61f266959faa1.png

Matches of the search can be found in the module's Output under Bundle > Body > results.

In our example, 104 collections were returned:

61f26696e2fc2.png

Searches

Search Documents

Search documents by given criteria.

Collection ID

Select or map the Collection ID whose documents you want to search.

Processing State

Select or map the document processing status:

  • Generated

  • Requested

  • Delivered

  • None

Ordering

Select or map the order to arrange the documents:

  • Newest changes first

  • Oldest changes first

Modified Before

Enter (map) the date to search the documents that were modified on or before the specified date. See the list of supported date and time formats.

Modified Since

Enter (map) the date to search the documents that were modified on or after the specified date. See the list of supported date and time formats.

Limit

Set the maximum number of results Ibexa Connect should return during one execution cycle.

Setting Up AX Semantics Webhooks

  1. Open the Watch Generated Content module, enter a name for the webhook, click Save, and copy the URL address to your clipboard. Click OK and save the trigger.

    61f2669820854.gif

  2. Log in to your AX Semantics account.

  3. Click the Project in which you want to add the webhook.

    61f2669acc99e.png

  4. Click the Settings button.

    61f2669be5cc0.png

  5. Click Instant Generation Endpoints.

    61f2669d22059.png

  6. Click Create a New Instant Generation Endpoint and enter the URL address copied in step 1.

    61f2669e619c6.png Log in to your AX Semantics account.

  7. Click the Project in which you want to add the webhook.

    61f2669acc99e.png

  8. Click the Settings button.

    61f2669be5cc0.png

  9. Click Instant Generation Endpoints.

    61f2669d22059.png

  10. Click Create a New Instant Generation Endpoint and enter the URL address copied in step 1.

    61f2669e619c6.png