AMCS Group CustomerBlob API

The CustomerBlob API from AMCS Group — 1 operation(s) for customerblob.

Specifications

OpenAPI Specification

amcs-group-customerblob-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  title: Core AccessGroup CustomerBlob API
  version: core
tags:
- name: CustomerBlob
paths:
  /blobs/customerBlobs:
    post:
      tags:
      - CustomerBlob
      summary: Create or update
      description: "| ------------------------------------- | ----------------------------------------------------------------------------- | -------- |\r\n| MediaContentBase64   | The Image/PDF converted to base 64| Yes |\r\n| DocumentName   | The Document Name| Yes |\r\n| DocumentReference   | The Document Reference                                                     | Yes |\r\n| RelatedInvoiceGuid   | The Related Invoice Guid| No |\r\n| RelatedCustomerGuid   | The Related Customer Guid| Yes |\r\n| CustomerExternalDocumentCategoryListItem | The GUID and description of the document category related to the external document | Yes |\r\n| IsAvailableOnPortal   | The flag used to decide availability of document in portal| No |\r\n\r\n**Extra validations**\r\n\r\n| Condition | Error message |\r\n| --------- | ------------- |\r\n| DocumentName is Null or not provided | The mandatory property DocumentName has a null value. The request could not be processed. Supply a value for the DocumentName property of the submitted resource. |\r\n| DocumentName has less than 5 characters  or more than 510 characters | CustomerExternalDocument has the property DocumentName with value of {DocumentName} that is not supported. DocumentName should be at least 1 character and at most 506 characters, excluding the extension |\r\n| DocumentName does not have any of pdf/png/jpg/gif extension  | CustomerExternalDocument has the property DocumentName with value of {DocumentName} that is not supported. DocumentName should have any of pdf/png/jpg/gif extension |\r\n| DocumentReference is Null or not provided | The mandatory property DocumentReference has a null value. The request could not be processed. Supply a value for the DocumentReference property of the submitted resource. |\r\n| RelatedCustomerGuid is Null or not provided | The mandatory property RelatedCustomerGuid has a null value. The request could not be processed. Supply a value for the RelatedCustomerGuid property of the submitted resource. |\r\n| Invalid RelatedCustomerGuid | Failed to retrieve Customer with RelatedCustomerGuid of {Guid} |\r\n| CustomerExternalDocumentCategoryListItem.Guid is Null or not provided | The mandatory property CustomerExternalDocumentCategoryListItem.Guid has a null value. The request could not be processed. Supply a value for the CustomerExternalDocumentCategoryListItem.Guid property of the submitted resource. |\r\n| Invalid CustomerExternalDocumentCategoryListItem.Guid | Failed to retrieve CustomerExternalDocumentCategory with CustomerExternalDocumentCategory.Guid of {Guid} |\r\n| MediaContentBase64 is Null or not provided | The mandatory property MediaContentBase64 has a null value. The request could not be processed. Supply a value for the MediaContentBase64 property of the submitted resource. |\r\n| MediaContentBase64 is not a valid base64 string | Failed to save/update CustomerExternalDocument because MediaContentBase64 has Invalid length for a Base-64 char array or string |\r\n\r\n##  Information\r\n| Information |\r\n| ----------- |\r\n| Currently we are only validating for a valid base64 string, we are not validating the string against the file extension |"
      operationId: CustomerBlob_Create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiIntegratorCustomerExternalDocumentResource'
        required: true
        x-bodyName: null
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResourceId'
components:
  schemas:
    ApiIntegratorListItemResource:
      type: object
      properties:
        Description:
          type: string
        Guid:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
    ApiResourceId:
      type: object
      properties:
        resource:
          type: string
          format: uuid
        errors:
          $ref: '#/components/schemas/ApiResourceErrors'
        status:
          $ref: '#/components/schemas/ApiResourceStatus'
    ApiResourceErrors:
      type: object
      properties:
        errors:
          type: string
    ApiIntegratorCustomerExternalDocumentResource:
      type: object
      properties:
        MediaContentBase64:
          type: string
        DocumentName:
          type: string
        DocumentReference:
          type: string
        CustomerExternalDocumentCategoryListItem:
          $ref: '#/components/schemas/ApiIntegratorListItemResource'
        RelatedInvoiceGuid:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        RelatedCustomerGuid:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        IsAvailableOnPortal:
          type: boolean
    ApiResourceStatus:
      type: object
      properties:
        id:
          type: integer
          format: int32
        isSuccess:
          type: boolean