Data Products

Get Data Product Documents Metadata

Changed on

Retrieves metadata for all documents of a data product. Accessible to the owning provider and admins. Producers and support users only see available documents of active data products.

get/api/products/v2/{id}/documents

Request

  • The document declares no server URL.
  • Auth
    OpenID Connect (http://localhost:6999/realms/agate/.well-known/openid-configuration, scopes: agridata.ch.Agridata_Datenanbieter, agridata.ch.Agridata_Admin, agridata.ch.Agridata_Einwilliger, agridata.ch.Agridata_Support)

Path parameters

idstring uuid required

Query parameters

actingRole'PROVIDER' | 'PRODUCER' | 'ADMIN' | 'SUPPORT'

Selects the role in which the authenticated user acts for this request. Optional: if the authenticated user holds exactly one of the allowed roles, the value is auto-resolved. Returns 400 if the value is unknown, not allowed for this endpoint, or omitted while the user holds multiple matching roles. Returns 403 if the user does not hold the role specified in the parameter.

Response

OK

idstring uuid required
fileNamestring required

Filename of the document

sizeBytesinteger required

Filesize of the document

scanStatus'PENDING_SCAN' | 'AVAILABLE' | 'REJECTED' | 'SCAN_FAILED' required

Example response

[
  {
    "fileName": "example.pdf",
    "sizeBytes": 1024
  }
]

Changes

  • 75957f6bdc66Revision changes
    • warning

      added the new EXPORT_CAPACITY_EXHAUSTED enum value to the response property for the response status

    • warning

      added the new EXPORT_CAPACITY_EXHAUSTED enum value to the response property for the response status

    • warning

      added the new EXPORT_LIMIT_EXCEEDED enum value to the response property for the response status

    • warning

      added the new EXPORT_LIMIT_EXCEEDED enum value to the response property for the response status

    • info

      the security scope agridata.ch.Agridata_Einwilliger was added to the endpoint's security scheme SecurityScheme

    • info

      the security scope agridata.ch.Agridata_Support was added to the endpoint's security scheme SecurityScheme

    • info

      added the new enum value PRODUCER to the query request parameter actingRole

    • info

      added the new enum value SUPPORT to the query request parameter actingRole

  • 1aa7b6ad5bccRevision changes
    • warning

      added the new UID_CLAIM_MISSING enum value to the response property for the response status

    • warning

      added the new UID_CLAIM_MISSING enum value to the response property for the response status