Your first API request

Sign in, then read records through the Data API.

1. Get a token

Shell
curl -X POST "https://your-identity-host/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@yourcompany.example", "password": "your-password" }'

The response contains an access token and a refresh token.

2. Call the Data API

Send the token and the context headers for the tenant, app and environment you are working in.

Shell
curl -X POST "https://your-data-host/api/v1/queries/select" \
  -H "Authorization: Bearer $TAF_TOKEN" \
  -H "TenantId: $TENANT_ID" -H "AppId: $APP_ID" -H "EnvironmentId: $ENVIRONMENT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "EntityName": "Vendor", "SelectedFields": ["Id", "Name"], "TopCount": 10 }'

You receive up to ten vendors your role can read. See the Data API reference.