id: https://nde.nl/ontology/hc/class/METSAPI
name: mets_api
title: METSAPI Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  dcat: http://www.w3.org/ns/dcat#
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
  premis: http://www.loc.gov/premis/rdf/v3/
  xsd: http://www.w3.org/2001/XMLSchema#
imports:
  - linkml:types
  - ../enums/METSIdentifierTypeEnum
  - ../metadata
  - ../slots/has_score
  - ../slots/has_format
classes:
  METSAPI:
    is_a: DataServiceEndpoint
    class_uri: hc:METSAPI
    description: "METS (Metadata Encoding and Transmission Standard) document retrieval\
      \ API.\n\n**Purpose:**\n\nModels endpoints that provide access to METS documents\
      \ describing\nthe structure and metadata of digital objects in heritage collections.\n\
      \nMETS is a Library of Congress standard widely used in digital preservation\n\
      and repository systems.\n\n**METS Structure:**\n\nA METS document contains:\n\
      - **metsHdr**: Header with creation/modification metadata\n- **dmdSec**: Descriptive\
      \ metadata (Dublin Core, MODS, EAD, etc.)\n- **amdSec**: Administrative metadata\
      \ (technical, rights, provenance)\n- **fileSec**: File inventory with technical\
      \ properties\n- **structMap**: Logical/physical structure of the object\n- **structLink**:\
      \ Links between structural divisions\n- **behaviorSec**: Executable behaviors\n\
      \n**Example - Nationaal Archief METS API:**\n\n```yaml\nmets_api:\n  endpoint_name:\
      \ \"Nationaal Archief METS API\"\n  base_url: \"https://service.archief.nl/gaf/api/mets/v1/\"\
      \n  url_pattern: \"{base_url}{uuid}\"\n  mets_profile: NATIONAAL_ARCHIEF\n \
      \ version: \"v1\"\n  descriptive_metadata_schemas:\n    - Dublin Core\n    -\
      \ EAD\n  rights_metadata_available: true\n  structural_metadata_available: true\n\
      \  file_inventory_included: true\n  example_url: \"https://service.archief.nl/gaf/api/mets/v1/12345678-1234-1234-1234-123456789012\"\
      \n```\n\n**Use Cases:**\n\n1. **Digital preservation**: Validate object integrity\n\
      2. **Viewer integration**: Build multi-page viewers from structural metadata\n\
      3. **Migration**: Transfer objects between repository systems\n4. **Audit**:\
      \ Track provenance and rights\n\n**See Also:**\n\n- METS Standard: https://www.loc.gov/standards/mets/\n\
      - METS Primer: https://www.loc.gov/standards/mets/METSPrimer.pdf\n"
    slot_usage:
      has_format:
        ifabsent: string(application/xml)
    comments:
    - METS is essential for digital preservation and repository interoperability
    - Structural maps enable building multi-page viewers
    - Consider caching METS documents for frequently accessed objects
    see_also:
    - https://www.loc.gov/standards/mets/
    - https://www.loc.gov/standards/mets/mets-schemadocs.html
    slots:
    - has_score
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: '[''*'']'