Files #

Swagger #

adminRights_api_v1.0.0.html

json #

adminRights_api_v1.0.0.json

yaml #

adminRights_api_v1.0.0.yaml

Source #

json #

{
  "openapi": "3.0.3",
  "info": {
    "title": "NovaFacies Open Source Project - Module 'AdminRights' v1",
    "description": "API specification for Module 'AdminRights' in NovaFacies Open Source Project. For more information, see https://novafacies.org",
    "version": "1.0.0",
    "contact": {
      "name": "NovaFacies Open Source Foundation",
      "url": "https://novafacies.org/",
      "email": "[email protected]"
    },
    "license": {
      "name": "GNU GPLv3",
      "url": "https://www.gnu.org/licenses/gpl-3.0.html"
    },
    "x-filename-json": "adminRights_api_v1.0.0.json",
    "x-filename-yaml": "adminRights_api_v1.0.0.yaml",
    "x-filename-html": "adminRights_api_v1.0.0.html"
  },
  "servers": [
    {
      "url": "https://api.adminrights.novafacies.org/v1",
      "description": "Production server"
    },
    {
      "url": "https://staging.api.adminrights.novafacies.org/v1",
      "description": "Staging server"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "This API expects a valid JWT Token in the Authorization header. The Authentication mechanism, including Token issuance and validation, is handled by the Auth Module."
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/adminRights/get": {
      "post": {
        "summary": "Retrieves rights for the admin role. Reference function with internal name: adminRights.getAdminRight",
        "description": "Retrieves rights for the admin role. Reference function with internal name: adminRights.getAdminRight",
        "operationId": "getAdminRight",
        "responses": {
          "200": {
            "description": "success",
            "content": {
              "application/json": {
                "examples": {
                  "success": {
                "value": {
                      "status": "success",
                      "admin_right_id": "right-admin-001",
                      "admin_role_id": "role-admin-001",
                      "admin_right_permissions": {
                        "all": "full-access"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "error",
            "content": {
              "application/json": {
                "examples": {
                  "badRequest": {
                    "value": {
                      "message": "error"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

yaml #

openapi: 3.0.3
info:
  title: NovaFacies Open Source Project - Module 'AdminRights' v1
  description: >-
    API specification for Module 'AdminRights' in NovaFacies Open Source
    Project. For more information, see https://novafacies.org
  version: 1.0.0
  contact:
    name: NovaFacies Open Source Foundation
    url: https://novafacies.org/
    email: [email protected]
  license:
    name: GNU GPLv3
    url: https://www.gnu.org/licenses/gpl-3.0.html
  x-filename-json: adminRights_api_v1.0.0.json
  x-filename-yaml: adminRights_api_v1.0.0.yaml
  x-filename-html: adminRights_api_v1.0.0.html
servers:
  - url: https://api.adminrights.novafacies.org/v1
    description: Production server
  - url: https://staging.api.adminrights.novafacies.org/v1
    description: Staging server
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        This API expects a valid JWT Token in the Authorization header. The
        Authentication mechanism, including Token issuance and validation, is
        handled by the Auth Module.
security:
  - BearerAuth: []
paths:
  /adminRights/get:
    post:
      summary: >-
        Retrieves rights for the admin role. Reference function with internal
        name: adminRights.getAdminRight
      description: >-
        Retrieves rights for the admin role. Reference function with internal
        name: adminRights.getAdminRight
      operationId: getAdminRight
      responses:
        '200':
          description: success
          content:
            application/json:
              examples:
                success:
                  value:
                    status: success
                    admin_right_id: right-admin-001
                    admin_role_id: role-admin-001
                    admin_right_permissions:
                      all: full-access
        '400':
          description: error
          content:
            application/json:
              examples:
                badRequest:
                  value:
                    message: error