List news articles needing entity/person linking

View as Markdown

Excludes articles already joined to entities/people and those marked with the linker sentinel unless processExisting=true. Returns standard Spring Data Page<T>. X-Linked-Excluded header contains count of excluded linked articles.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

processExistingbooleanOptional

Include linker-sentinel articles for reprocessing.

includeTotalbooleanOptional
Compute the exact candidate total when more rows may exist.
includeLinkedExcludedbooleanOptional

Include the X-Linked-Excluded count response header.

filterSentinelInDbbooleanOptional

Filter linker-sentinel rows in the database; false prefilters the first page.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 100
The size of the page to be returned
sortlist of stringsOptional

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response headers

X-Linked-Excludedinteger

Count of already-linked articles excluded from the candidate page when includeLinkedExcluded=true

Response

Paginated candidates with optional linked-excluded count header

contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error