Authz1 Transactions API OpenAPI Spec (YAML)

openapi: 3.0.1
info:
  title: Authz1 Transactions API
  description: Authz1 Transactions API
  termsOfService: http://authz1.com/terms/
  contact:
    name: Authz1 Support
    url: http://www.authz1.com/contact
    email: support@authz1.com
  license:
    name: Authz1 Intellectual Property
    url: https://www.authz1.com
  version: 2.0.1
servers:
  - url: https://sandbox.authz1.com/v1
    description: Sandbox server
paths:
  /transactions:
    post:
      description: >-
        Commits the transaction with the parameters in the request and teturns
        the limits which are effective for the transaction
      operationId: commitTransaction
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                subjectId:
                  description: ''
                  type: string
                actionId:
                  description: ''
                  type: string
                resourceId:
                  description: ''
                  type: string
                trxDateTime:
                  description: ''
                  type: string
                trxId:
                  description: ''
                  type: string
                trxAmount:
                  description: ''
                  type: number
                unit:
                  description: ''
                  type: string
                passLimits:
                  description: ''
                  type: array
                  items:
                    type: string
              required:
                - subjectId
                - actionId
                - resourceId
                - trxDateTime
                - trxId
                - trxAmount
                - unit
      responses:
        '200':
          description: List of limits and the overall result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/transactionResponse'
        '400':
          description: Bad Request
          content:
            application/json: {}
        '404':
          description: Not Found
          content:
            application/json: {}
        '500':
          description: Internal Server Error
          content:
            application/json: {}
  /transactions/{transactionId}:
    patch:
      description: >-
        Recommits the transaction with the parameters in the request and teturns
        the limits which are effective for the transaction
      operationId: recommitTransaction
      parameters:
        - name: transactionId
          in: path
          description: The ID of the transaction
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                subjectId:
                  description: ''
                  type: string
                actionId:
                  description: ''
                  type: string
                resourceId:
                  description: ''
                  type: string
                trxDateTime:
                  description: ''
                  type: string
                trxId:
                  description: ''
                  type: string
                trxAmount:
                  description: ''
                  type: number
                unit:
                  description: ''
                  type: string
                passLimits:
                  description: ''
                  type: array
                  items:
                    type: string
              required:
                - subjectId
                - actionId
                - resourceId
                - trxDateTime
                - trxId
                - trxAmount
                - unit
      responses:
        '200':
          description: List of limits and the overall result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/transactionResponse'
        '400':
          description: Bad Request
          content:
            application/json: {}
        '404':
          description: Not Found
          content:
            application/json: {}
        '500':
          description: Internal Server Error
          content:
            application/json: {}
components:
  schemas:
    transactionResponse:
      type: object
      properties:
        userId:
          type: string
        transactionId:
          type: string
        transactionAmount:
          type: number
        unit:
          type: string
        actionId:
          type: string
        passLimits:
          type: array
          items:
            type: string
        result:
          type: boolean
        limits:
          type: array
          items:
            $ref: '#/components/schemas/limit'
    limit:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        type:
          type: string
        amount:
          type: number
        remainingAmount:
          type: number
        timePeriod:
          type: string
        actionId:
          type: string
        resourceId:
          type: string
        level:
          type: string
        subjectId:
          type: string
        subjectName:
          type: string
        withinLimit:
          type: boolean
        definedBy:
          type: string
        effective:
          type: boolean