openapi: 3.0.1
info:
  version: 1.0.11
  title: "OpenAIRE: (meta)data use vocabularies that follow FAIR principles"
  description: >-
    Assessed by checking that the datacite:resourceType and datacite:rights fields are populated with values drawn from the eu-repo namespace, as prescribed by the OpenAIRE Guidelines for Data Archives. The use of these standardized vocabularies confirms that the (meta)data employ FAIR-aligned, interoperable terms that are formally defined, openly accessible, and consistently applicable across systems.
  x-applies_to_principle: https://doi.org/10.25504/FAIRsharing.96d4af
  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/I2_data:
    post:
      summary: "POST: Test I2_data"
      description: >-
        Submit a POST request with a resource identifier to test whether the resource satisfies the conditions for test I2_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."