Directory

Directory HTTP endpoints — four `GET` calls under `/api/directory` backing the four-level drill-down (data source types → data sources → entity types → entities).

The Directory is backed by four GET endpoints in DirectoryController.java. Every level on the UI maps to one call; the display names and entity counts surfaced at level 1 are derived at request time by parsing the ODDRN of every registered data source through oddrn-generator's Generator.parse(...). For the level-by-level walkthrough and the relationship to the Catalog Overview surface, see the Directory page.

Method

Path

Operation ID

Purpose

GET

/api/directory

getDataSourceTypes

Level 1 — list every ODDRN-prefix that has at least one registered data source, with display name and entity count.

GET

/api/directory/datasources?prefix={type-prefix}

getDirectoryDatasourceList

Level 2 — list registered data sources for the given prefix; each result carries the source's ODDRN-derived properties and per-source entity count.

GET

/api/directory/datasources/{data_source_id}/types

getDatasourceEntityTypes

Level 3 — list DataEntityType values present in the given data source.

GET

/api/directory/datasources/{data_source_id}?type_id={type-id}&page={n}&size={m}

getDatasourceEntities

Level 4 — paged list of entities of the chosen type within the chosen data source. Delegates to DataEntityService.

See also