Paginated sitemap URL slots for entity types

GET

https://api.aventure.vc/v1/sitemap/entities/urls

GET

/v1/sitemap/entities/urls

curl -G https://api.aventure.vc/v1/sitemap/entities/urls \
     -d typeRecord=string

{
  "content": [
    {
      "entityId": "string",
      "lastUpdatedAt": "2024-01-15T09:30:00Z",
      "path": "string",
      "slotKey": "string",
      "slug": "aventure-vc",
      "typeRecord": "Company",
      "urlType": "overview",
      "productServiceSlug": "aventure-vc"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Large paginated list serving front-end sitemap.xml generation; not an enrichment read or write surface. Returns one row per concrete entity URL; the slot path and lastmod come from a materialized projection refreshed asynchronously after writes, so rows are eventually consistent. XML page limits count URLs, not parent entities.

Query parameters

typeRecordlist of stringsRequired

Entity type filters whose sitemap URLs to list. Repeat for multiple types.

cursorstringOptional

Cursor for pagination (format: timestamp::slotKey)

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 5000

The size of the page to be returned

Response headers

X-Next-CursorstringOptional

Opaque continuation token; reuse the same filters and forward unchanged.

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error