openapi: 3.0.1
info:
  version: 1.0.11
  title: "OpenAIRE: (meta)data are retrievable by their identifier using a standardized communications protocol"
  description: >-
    Assessed by verifying that the resource's metadata are exposed and retrievable via the OAI-PMH protocol, in compliance with the OpenAIRE Guidelines for Data Archives. Compliance is determined by validating that the repository endpoint conforms to the OpenAIRE OAI-PMH requirements, ensuring metadata can be harvested through this open, standardized protocol.
  x-applies_to_principle: https://doi.org/10.25504/FAIRsharing.7014eb
  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/A1_data:
    post:
      summary: "POST: Test A1_data"
      description: >-
        Submit a POST request with a resource identifier to test whether the resource satisfies the conditions for test A1_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."