Feed API Endpoint
| Property | Value |
|---|
| Base URL | https://feed.api.eu1.scalar.zf.com |
| Endpoint | /v1/feed/{feedId} |
| HTTP Method | GET |
| Content-Type | application/json |
| Rate Limit | XLarge (reviewed for extreme usage patterns) |
| Feature | datahub-subscription |
Path Parameters
| Parameter | Type | Required | Description |
|---|
| feedId | string | Yes | Unique identifier for your Feed subscription (UUID format) |
| Parameter | Type | Required | Default | Min | Max | Description |
|---|
| limit | integer | No | 100 | 100 | 250 | Number of records to return in single request |
| Header | Required | Example |
|---|
| Authorization | Yes | Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... |
| Content-Type | No | application/json |
The Feed API returns data in a standardized JSON structure:
{
"items": [
{
"eventType": "string",
"eventVersion": "integer",
"eventData": {
// Event-specific payload
}
}
],
"hasNext": "boolean"
}
| Status Code | Meaning | Description |
|---|
| 200 OK | Success | Feed data retrieved successfully |
| 400 Bad Request | Invalid Request | Invalid parameters or malformed request |
| 401 Unauthorized | Auth Failed | Missing or invalid authorization token |
| 403 Forbidden | Access Denied | Integrator lacks permission for this feed |
| 404 Not Found | Feed Inactive | Feed subscription is deactivated or doesn't exist |
| 429 Too Many Requests | Rate Limited | Request rate limit exceeded |
| 500 Server Error | Server Issue | Internal server error; retry after delay |
| 503 Service Unavailable | Service Down | Service temporarily unavailable; retry after delay |
