/providers/{NamespaceID}/{ProviderID}/FactData
This endpoint returns the fact data for the specified provider.
Using this fact data endpoint, you can also create a new subscription for that specific model, by including the OData header Prefer set to odata.track-changes. This lets the Data Export Service know that you want to track data changes on a given model.
API Request Details
|
URL |
{BaseURL}/providers/{NamespaceID}/{ProviderID}/FactData |
|
Request Type |
GET |
|
Content Type |
application/json |
|
Required Header |
|
|
Name |
Prefer |
|
Value |
odata.track-changes |
The reponse can also be generated in .CSV format using the $format=text/csv parameter in the request.
Additional Parameters
-
$select: use this parameter to specify columns to select. For example, $select=MyColumn1,MyColumn2
-
$filter: use this parameter to filter the result set according to the filter string. For example, MyColumn1 eq 'myColumn1'.
Note
You can also create a subscription using a POST request. This is useful if you want to specify an ExternalID by which to reference the subscription chain and a description to indicate the changes the subscription is tracking, or to filter or perform selections on the results. If you use $select, make sure to select all dimensions as they are mandatory. Only measures are optional. These fields can be specified in the JSON body of the post request, which should also include the NamespaceID, ProviderID, and the EntitySetName. For more information, see /administration/Subscriptions (POST).
Sample Response
{
"@odata.context": "$metadata#FactData",
"value": [
{
"Version": "actual",
"Account": "400000",
"Region": "USA",
"Product": "Mountain_Bike",
"Currency": "CAD",
"Time": "202201",
"MyMeasure1": 10.11
}
},
"@odata.deltaLink": "{BASE_URL}/providers/{namespaceID}/{providerID}/FactData?deltaid={deltaID}"
}