Getting started

Welcome to dSilo Data API Hub (UAT)

This portal explains how to authenticate, attach the right headers, and call the contracts and invoices summary APIs through Azure API Management.

Gateway base URL: https://dsilo-apim-stage-01.azure-api.net/dsilo/

Every data call requires three credentials: (1) Microsoft Entra access token, (2) APIM subscription key issued for your UAT access, and (3) backend x-api-key. Portal pages use placeholders only: <ACCESS-TOKEN>, <SUBSCRIPTION-KEY>, <API-Key>.

1. Obtain an Entra access token

Use OAuth 2.0 client credentials against your Microsoft Entra tenant.

Token endpoint: https://login.microsoftonline.com/<TENANT-ID>/oauth2/v2.0/token

grant_type=client_credentials

client_id=<CUSTOMER-CLIENT-ID>

client_secret=<CUSTOMER-CLIENT-SECRET>

scope=api://<app-id>/.default

Copy only access_token from the response. Do not use id_token. Your application must be granted the Data.Read app role.

3. Attach required headers

Authorization: Bearer <ACCESS-TOKEN>

Ocp-Apim-Subscription-Key: <SUBSCRIPTION-KEY>

x-api-key: <API-Key>

Accept: application/json or application/vnd.apache.parquet

Content-Type: application/json when sending a JSON body

4. Call a summary endpoint

POST https://dsilo-apim-stage-01.azure-api.net/dsilo/v1/contracts/summary

POST https://dsilo-apim-stage-01.azure-api.net/dsilo/v1/invoices/summary

Send filters as JSON. Prefer body over query when the same filter appears in both. Filter names are case-sensitive. Date ranges use YYYY-MM-DD, From ≤ To, max one month span.

5. Understand the JSON response

data — allowlisted records

pagination — page, pageSize, totalRecords, totalPages, hasNext

meta.requestId — same value as X-Request-ID; use for support

meta.generatedAt — ISO timestamp

meta.warning — optional

Checklist

Token request returns access_token

JSON summary returns 200 with data / pagination / meta

Invoices Parquet returns a zip with invoices.parquet and invoice_tables.parquet

Documented errors behave as expected when deliberately triggered

Remove secrets from saved examples and logs