National Yang Ming Chiao Tung University

National Yang Ming Chiao Tung University Roles API

The Roles API from National Yang Ming Chiao Tung University — 2 operation(s) for roles.

GitHub OpenAPI

Documentation

📖
Documentation
https://guides.dataverse.org/en/5.10.1/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/openapi/nycu-roles-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/json-schema/nycu-dataset-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/json-structure/nycu-dataset-structure.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/examples/nycu-search-example.json
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/rules/nycu-rules.yml
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/vocabulary/nycu-vocabulary.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/nycu/refs/heads/main/json-ld/nycu-context.jsonld

OpenAPI Specification

nycu-roles-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  title: NYCU Dataverse Native & Search Access Roles API
  description: OpenAPI description served by the National Yang Ming Chiao Tung University (NYCU) Dataverse research-data repository (Dataverse Project v5.10.1) at https://dataverse.lib.nycu.edu.tw. Captured unmodified from the live /openapi endpoint; only the servers and info blocks were adjusted to point at the public base URL.
  version: 5.10.1
servers:
- url: https://dataverse.lib.nycu.edu.tw
  description: NYCU Dataverse production instance.
tags:
- name: Roles
paths:
  /api/v1/roles:
    post:
      operationId: createNewRole
      parameters:
      - name: dvo
        in: query
        schema:
          type: string
      requestBody:
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/RoleDTO'
      responses:
        default:
          content:
            '*/*':
              schema:
                type: object
          description: Default Response.
      tags:
      - Roles
  /api/v1/roles/{id}:
    get:
      operationId: viewRole
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        default:
          content:
            '*/*':
              schema:
                type: object
          description: Default Response.
      tags:
      - Roles
    delete:
      operationId: deleteRole
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        default:
          content:
            '*/*':
              schema:
                type: object
          description: Default Response.
      tags:
      - Roles
components:
  schemas:
    RoleDTO:
      type: object
      properties:
        alias:
          type: string
        name:
          type: string
        description:
          type: string
        ownerId:
          type: string
        permissions:
          type: string