Run Data Services Extracts Using REST Requests

You can execute Data Services using EQL and Generic Extractor REST APIs.

Below are examples showing how to run Data Services extracts using the MC2 Swagger UI.

Run Data Services Extracts using Generic Extractor

One option to run EBS extracts is to use the Generic Extractor REST API. You can retrieve the Swagger for the Generic Extractor REST API at:

https://eagle-web-server/eagle/v2/generic/extract/api-doc

The Generic Extract REST API allows for the execution of multiple extracts, both standard EagleML extracts and Data Services extracts with one HTTP POST request and returns the extracted data in a ZIP file.

All parameters supported by the Generic Extractor are supported in the REST request.

To execute a test REST request you can use the MC2 Swagger UI.

1. Open the browser (Chrome) to point to the mc2/swagger-ui.html endpoint:

https://eagle-web-server/mc2/swagger-ui.html

2. Select Generic Extractor from the dropdown list in the right top corner:

3. Click on eaglegenericextractrestapi, then click on POST and Try It Out:

4. In the Example Value Model add:

{
  "extractParameters": [
    {
      "name": "ebs:default:outputformat",
      "value": "EagleJSON"
    },

    {
      "name": "ebs:default:invalidatecache",
      "value": "Y"
    }
  ],
  "extracts": [
    {
      "name": "ebs:genericentity",
      "extractParameters": [
        {
          "name": "maxrows",
          "value": "5"
        }
      ]
    },
    {
      "name": "ebs:interfaces",
      "extractParameters": [
        {
          "name": "maxrows",
          "value": "10"
        }
      ]
    }
  ]

}

5. Click Execute.

The result will be a ZIP file with two extracts as show below:

When you download the zip, you see two files:

Run Data Services Extracts Using EQL REST API

The EQL REST API Swagger is available at:

http://eagle-web-server/eagle/v2/eql/api-doc

The EQL interface allows for the execution of a custom or core Eagle Data Services interface.

You can execute a request from the EQL REST API using the MC2 Swagger UI at

http://eagle-web-server/mc2/swagger-ui.html

1. Select EQL from the dropdown list:
   
2. Click eql-rest, then click POST and Try it Out>.
   
3. In the Example Value Model enter the following:

{
            "FeedType" : "genericentity" ,
            "emlObjectType": "Entity",
            "outputformat": "EagleJSON",
            "filters": {
                "maxrows" : "5"
            },
            "SaveSQLQuery": "Y",
            "invalidatecache": "Y"
}

4. Click Execute.

The result is shown in the Response Body box below:

Sample POST body to execute a user defined EDS interface:

{
 "FeedType" : "wh_position_smf_ratings",
 "outputformat": "EagleJSON",
 "filters": {
  "effectivedate" : "2019-06-09",
  "entityId" : "ASTL1900"
  }
}