1NCE Service Requests API

openapi: 3.0.1
info:
  title: Authorization Administration Logs Service Requests API
  description: Documentation of the authentication used for the 1NCE APIs.
  contact:
    name: 1NCE GmbH
    url: https://1nce.com
    email: info@1nce.com
  version: v2.1.1
servers:
- url: https://api.1nce.com/management-api
tags:
- name: Service Requests
  description: Support Management
paths:
  /v1/support:
    get:
      tags:
      - Service Requests
      summary: Get Service Requests
      description: Get a list of all customer service requests.
      operationId: getServiceRequestsUsingGET
      parameters:
      - name: page
        in: query
        description: Number index of the requested service request page. Use this parameter to iterate through all service requests on the different pages. The total amount of pages is listed in the response header.
        allowEmptyValue: false
        schema:
          minimum: 1
          exclusiveMinimum: false
          type: integer
          default: 1
      - name: pageSize
        in: query
        description: The number of service requests per page, maximum allowed value is 100.
        allowEmptyValue: false
        schema:
          maximum: 100
          exclusiveMaximum: false
          minimum: 1
          exclusiveMinimum: false
          type: integer
          default: 1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Service_request'
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Service_request'
        '401':
          description: Unauthorized
          content: {}
        '403':
          description: Forbidden
          content: {}
        '404':
          description: Not Found
          content: {}
      deprecated: false
      security:
      - BearerAuthentication: []
    post:
      tags:
      - Service Requests
      summary: Create Service Request
      description: Create a new service request towards 1NCE Support.
      operationId: createServiceRequestUsingPOST
      requestBody:
        description: Content of the to be created service request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManagementApiServiceRequest'
        required: true
      responses:
        '200':
          description: OK
          content: {}
        '201':
          description: Created
          content: {}
        '401':
          description: Unauthorized
          content: {}
        '403':
          description: Forbidden
          content: {}
        '404':
          description: Not Found
          content: {}
      deprecated: false
      security:
      - BearerAuthentication: []
      x-codegen-request-body-name: request
components:
  schemas:
    ManagementApiServiceRequest:
      title: Service Request
      type: object
      properties:
        replyToMail:
          type: string
          description: Customer e-mail address for the communication about the service request.
          example: e-mail@address.com
        senderName:
          type: string
          description: Name of the person opening the service request.
          example: Hans Mustermann
        subject:
          type: string
          description: Subject of the service request ticket.
          example: Connectivity Issue
        text:
          type: string
          description: Text body of the service request ticket.
          example: Custom Text
    Service_request:
      title: Service Request
      type: object
      properties:
        caseId:
          type: string
          description: String case id to reference the support case.
          example: '12'
        communications:
          type: array
          items:
            $ref: '#/components/schemas/Communication'
        createDate:
          type: string
          description: Timestamp when the service request was created.
          format: date-time
        solvedDate:
          type: string
          description: Timestamp when the service request was marked as solved.
          format: date-time
        status:
          type: string
          description: Current status of the service request.
          example: OPEN
          enum:
          - OPEN
          - IN_PROGRESS
          - CLOSED
        subject:
          type: string
          description: Subject of the service request ticket.
          example: Connectivity Issue
        text:
          type: string
          description: Text body of the service request ticket.
          example: Custom Text
      description: Detailed content of the service request ticket.
    Communication:
      title: Communication Details
      type: object
      properties:
        communicationDate:
          type: string
          description: Timestamp of the communication.
          format: date-time
        direction:
          type: string
          description: Direction of the communication of the service request.
          example: IN
          enum:
          - IN
          - OUT
        id:
          type: string
          description: ID of the communication.
          example: '1'
        originator:
          type: string
          description: Origin of the service request.
        subject:
          type: string
          description: Subject of the service request.
          example: Connectivity Issues
        text:
          type: string
          description: Text message of the service request.
          example: Custom Text
        type:
          type: string
          description: Source of the communication of the service request.
          example: Portal
          enum:
          - PORTAL
          - PHONE_IN
          - PHONE_OUT
          - MAIL_IN
          - MAIL_OUT
      description: Details about the communication in the service request.
  securitySchemes:
    BasicAuthentication:
      type: http
      scheme: basic
      description: Basic authentication used for obtaining the Bearer Authentication Token. The Bearer Token can then be used to make any further API calls towards the 1NCE API.