# WikidataApiMetadata - API call metadata
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08

id: https://nde.nl/ontology/hc/classes/WikidataApiMetadata
name: WikidataApiMetadata
title: WikidataApiMetadata

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#
  http: http://www.w3.org/2011/http#

imports:
  - linkml:types


default_range: string

classes:
  WikidataApiMetadata:
      description: >-
        Metadata about Wikidata API calls including endpoint, timestamp,
        authentication status, response metrics, and rate limiting information.
        
        Ontology mapping rationale:
        - class_uri is prov:Activity because an API call is an activity that
          retrieves data from Wikidata.
        - close_mappings includes http:Request from W3C HTTP Vocabulary as
          API calls are HTTP requests.
        - related_mappings includes schema:Action as an API call is an action
          with inputs and outputs.
      class_uri: prov:Activity
      close_mappings:
        - http:Request
      related_mappings:
        - schema:Action
        - prov:Entity
      attributes:
        api_endpoint:
          range: uri
          description: Wikidata API endpoint URL
        has_or_had_api_endpoint:
          range: uri
          description: Wikidata API endpoint URL (alternative RiC-O style name)
        fetch_timestamp:
          range: datetime
        user_agent:
          range: string
        enrichment_version:
          range: string
        properties_found:
          range: string
          multivalued: true
          inlined_as_list: true
          description: Wikidata property IDs found (P31, P17, etc.)
        request_url:
          range: uri
          description: Full request URL
        response_status:
          range: integer
          description: HTTP response status code
        response_time_ms:
          range: float
          description: Response time in milliseconds
        authenticated:
          range: boolean
          description: Whether request was authenticated
        rate_limit_delay_used:
          range: float
          description: Rate limit delay used in seconds