openapi: 3.0.1
info:
  version: 1.0.11
  title: "OpenAIRE: (meta)data are associated with detailed provenance"
  description: >-
    Assessed by checking the presence of provenance-relevant metadata fields: datacite:creator, datacite:contributor, datacite:date, and datacite:version, as well as the presence of datacite:relatedIdentifier with a relationType attribute set to one of the following values: IsSupplementTo, IsSupplementedBy, IsContinuedBy, Continues, IsDescribedBy, Describes, HasMetadata, IsMetadataFor, HasVersion, IsVersionOf, IsNewVersionOf, IsPreviousVersionOf, IsPartOf, HasPart, IsDocumentedBy, Documents, IsCompiledBy, Compiles, IsVariantFormOf, IsOriginalFormOf, IsIdenticalTo, IsDerivedFrom, or IsSourceOf. The population of these fields confirms that the (meta)data are associated with detailed provenance, enabling users to trace the origin, history, and context of the resource.
  x-applies_to_principle: https://fairsharing.org/FAIRsharing.3e9860
  contact:
    x-organization: "OpenAIRE"
    url: "https://www.openaire.eu"
    name: "Katerina Iatropoulou"
    x-role: responsible developer
    email: "kiatrop@athenarc.gr"
    x-id: "https://orcid.org/0000-0001-9991-9719"
servers:
  - url: "https://beta.services.openaire.eu/osTrails"
paths:
  /tests/R1.2_data:
    post:
      summary: "POST: Test R1.2_data"
      description: >-
        Submit a POST request with a resource identifier to test whether the resource satisfies the conditions for test R1.2_data.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/TestRequest"
      responses:
        "200":
          description: "The test result: pass or fail"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TestResponse"
components:
  schemas:
    TestRequest:
      required:
        - resource_identifier
      properties:
        resource_identifier:
          type: string
          format: uri
          description: "A resolvable URL to an OAI PMH endpoint identifying the resource to be assessed."

    TestResponse:
      type: object
      properties:
        result:
          type: string
          enum: [pass, fail]
          description: "Outcome of the FAIR test."