schema-api.yaml

openapi: 3.0.1
info:
  title: Sunbird RC - Schema APIs
  description: Schema APIs
  termsOfService: https://sunbirdrc.dev/
  contact:
    email: sunbird@example.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.0.0
servers:
- url: https://sunbirdrc.dev/api/v1
security:
- Authorization: []
tags:
- name: Credential Schemas
- name: Rendering Templates
paths:
  /credential-schema:
    post:
      tags:
        - Credential Schemas
      summary: Create credential schema
      operationId: createCredentialSchema
      requestBody:
        description: Payload
        content:
          'appliation/json':
            schema:
              $ref: '#/components/schemas/credentialSchemaRequest'
        required: true
      responses:
        201:
          description: Credential Schema successfully created!
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/credentialSchemaResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
    get:
      tags:
       - Credential Schemas
      summary: Get credential schema by tags
      operationId: getCredentialSchemas
      parameters:
        - in: query
          name: tags
          schema:
            type: string
            example: tag1,tag2
      responses:
        201:
          description: Credential Schemas
          content:
            'application/json':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/credentialSchemaResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
  /credential-schema/{id}:
    get:
      tags:
        - Credential Schemas
      summary: Get credential schema by id
      operationId: getCredentialSchema
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        200:
          description: Response
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/credentialSchemaResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
    put:
      tags:
        - Credential Schemas
      summary: Update credential schema by id
      description: Create a new version of credential schema
      operationId: updateCredentialSchema
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        description: Payload
        content:
          'appliation/json':
            schema:
              $ref: '#/components/schemas/credentialSchemaRequest'
        required: true
      responses:
        200:
          description: Credential Schema successfully updated!
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/credentialSchemaResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
  /template:
    post:
      tags:
        - Rendering Templates
      summary: Create redenring templates
      operationId: createRenderingTemplates
      requestBody:
        description: Payload
        content:
          'appliation/json':
            schema:
              $ref: '#/components/schemas/renderingTemplateRequest'
        required: true
      responses:
        201:
          description: Rendering template successfully created!
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/renderingTemplateResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
    get:
      tags:
        - Rendering Templates
      summary: Get rendering templates by schema id
      operationId: getRenderingTemplatesBySchemaId
      parameters:
      - name: schemaId
        in: query
        required: true
        schema:
          type: string
      responses:
        200:
          description: Response
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/renderingTemplateResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
  /template/{id}:
    get:
      tags:
        - Rendering Templates
      summary: Get rendering templates by id
      operationId: getRenderingTemplates
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        200:
          description: Response
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/renderingTemplateResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
    put:
      tags:
        - Rendering Templates
      summary: Update rendering templates by id
      description: Create a new version of template
      operationId: updateRenderingTemplates
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        description: Payload
        content:
          'appliation/json':
            schema:
              $ref: '#/components/schemas/renderingTemplateRequest'
        required: true
      responses:
        200:
          description: Rendering template successfully updated!
          content:
            'application/json':
              schema:
                $ref: '#/components/schemas/renderingTemplateResponse'
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}
    delete:
      tags:
        - Rendering Templates
      summary: Delete rendering templates by id
      operationId: deleteRenderingTemplates
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        200:
          description: Credential Schema successfully deleted!
        400:
          description: Invalid Input
          content: {}
        500:
          description: error
          content: {}

components:
  schemas:
    renderingTemplateResponse:
      allOf:
        - $ref: '#/components/schemas/renderingTemplateRequest'
        - type: object
          properties:
            templateId:
              type: string
    renderingTemplateRequest:
      type: object
      properties:
        template:
          type: string
        type:
          type: string
          enum: 
            - Handlebar
        schema:
          type: string
          example: schemaID
    credentialSchemaRequest:
      type: object
      properties:
        name:
          type: string
        schema:     
          type: object 
          example: '{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"Email","type":"object","properties":{"emailAddress":{"type":"string","format":"email"}},"required":["emailAddress"],"additionalProperties":false}'
        tags:
          type: array
          items:
            type: string
    credentialSchemaResponse:
      type: object
      properties:
        type: 
          type: string
        id:
          type: string
          pattern: "^\\d+\\.\\d+$"
          example: "did:example:MDP8AsFhHzhwUvGNuYkX7T/06e126d1-fa44-4882-a243-1e326fbe21db;version=1.1"
        version:
          type: string
        name:
          type: string
        author:
          type: string
        authored:
          type: string
        schema:     
          type: object 
          example: '{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"Email","type":"object","properties":{"emailAddress":{"type":"string","format":"email"}},"required":["emailAddress"],"additionalProperties":false}'
        proof:
          type: object
        tags:
          type: array
          items:
            type: string
  securitySchemes:
    Authorization:
      type: apiKey
      name: Token
      in: header