AQL is Krishagni's proprietary query language to query data without needing to know the relational model of the underlying database. At present, there is no comprehensive documentation on AQL. Therefore we suggest users who are interested in running queries programmatically to use the below-mentioned approach:
- Create the desired query using the UI wizard. For more details, please watch the video Introduction to OpenSpecimen Query Tool - YouTube
- Once you are satisfied with the query results, do the following
- open the network tab in browser's inspect mode
- rerun the query
- you will notice a couple of API calls made to the resource
/queryusingHTTP POSTmethod - one call for obtaining the counts and another to obtain the data for display in grid - the POST request body will have the required AQL for use in running the queries programmatically
- use the POST request body to invoke the query API and get the required data
Refer this document for more details on Query API.
We agree this sounds like a tedious and hotchpotch method, believe us, in the face of a continuously evolving software system, the working software itself serves as the comprehensive documentation about the topic you are interested in.