openapi: 3.0.1
info:
  version: 1.0.11
  title: "OpenAIRE: metadata clearly and explicitly include the identifier of the data it describes"
  description: >-
    Assessed by checking that the datacite:relatedIdentifier field is present with a relationType attribute set to one of the following values: IsMetadataFor, Describes, Documents or IsSupplementTo. The presence of at least one of these qualified links confirms that the metadata explicitly references the identifier of the data it describes.
  x-applies_to_principle: https://fairsharing.org/10.25504/FAIRsharing.820324
  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/F3_data:
    post:
      summary: "POST: Test F3_data"
      description: >-
        Submit a POST request with a resource identifier to test whether the resource satisfies the conditions for test F3_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."