Skip to content

formkiq/formkiq-client-sdk-python

Repository files navigation

formkiq-client

Formkiq API: Document Management Platform API using OAuth(JWT) Authentication

You can find out more about FormKiQ at https://formkiq.com.

Introduction

FormKiQ is an API-first (head-less), battle-tested document management API. The FormKiQ API provides all the API endpoints to build your Perfect Document Management Platform.

FormKiQ API was built on top of OpenAPI specification, so it is easy to use the API spec file with any application that supports the OpenAPI specification.

Open API OAuth Specification - https://raw.githubusercontent.com/formkiq/formkiq-core/master/docs/openapi/openapi-jwt.yaml

Open API IAM Specification - https://raw.githubusercontent.com/formkiq/formkiq-core/master/docs/openapi/openapi-iam.yaml

Authentication

FormKiQ offers three forms of authentication:

  • OAuth(JWT)
  • AWS IAM
  • API Key

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1.14.0
  • Package version: 1.0.0
  • Generator version: 7.4.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://formkiq.com

Requirements.

Python 3.7+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import formkiq_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import formkiq_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import formkiq_client
from formkiq_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost
# See configuration.py for a list of all supported configuration parameters.
configuration = formkiq_client.Configuration(
    host = "http://localhost"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.


# Enter a context with an instance of the API client
with formkiq_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = formkiq_client.AccessControlApi(api_client)
    document_id = 'document_id_example' # str | Document Identifier
    add_document_access_attributes_request = formkiq_client.AddDocumentAccessAttributesRequest() # AddDocumentAccessAttributesRequest | 
    site_id = 'site_id_example' # str | Site Identifier (optional)

    try:
        # Add document access attributes
        api_response = api_instance.add_document_access_attributes(document_id, add_document_access_attributes_request, site_id=site_id)
        print("The response of AccessControlApi->add_document_access_attributes:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AccessControlApi->add_document_access_attributes: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://localhost

Class Method HTTP request Description
AccessControlApi add_document_access_attributes POST /documents/{documentId}/accessAttributes Add document access attributes
AccessControlApi delete_document_access_attributes DELETE /documents/{documentId}/accessAttributes Delete document's access attributes
AccessControlApi delete_opa_configuration DELETE /sites/{siteId}/opa/accessPolicy Delete OPA Configuration
AccessControlApi get_document_access_attributes GET /documents/{documentId}/accessAttributes Get document access attributes
AccessControlApi get_opa_configuration GET /sites/{siteId}/opa/accessPolicy Get OPA Configuration
AccessControlApi get_opa_configurations GET /sites/opa/accessPolicies Get OPAs Configuration
AccessControlApi set_document_access_attributes PUT /documents/{documentId}/accessAttributes Set document access attributes
AccessControlApi set_opa_configuration PUT /sites/opa/accessPolicies Set OPA Configuration
AdvancedDocumentSearchApi add_document_fulltext POST /documents/{documentId}/fulltext Add document's full-text
AdvancedDocumentSearchApi delete_document_fulltext DELETE /documents/{documentId}/fulltext Delete document full-text
AdvancedDocumentSearchApi delete_document_fulltext_tag DELETE /documents/{documentId}/fulltext/tags/{tagKey} Delete document full-text tag
AdvancedDocumentSearchApi delete_document_fulltext_tag_and_value DELETE /documents/{documentId}/fulltext/tags/{tagKey}/{tagValue} Delete document full-text tag/value
AdvancedDocumentSearchApi get_document_fulltext GET /documents/{documentId}/fulltext Get document's full-text
AdvancedDocumentSearchApi query_fulltext POST /queryFulltext Direct opensearch search API
AdvancedDocumentSearchApi search_fulltext POST /searchFulltext Document full-text search
AdvancedDocumentSearchApi set_document_fulltext PUT /documents/{documentId}/fulltext Set document's full-text
AdvancedDocumentSearchApi update_document_fulltext PATCH /documents/{documentId}/fulltext Update document's full-text
AntivirusApi set_antivirus PUT /documents/{documentId}/antivirus Antivirus document scan
CaseManagementApi add_case POST /cases Add New Case
CaseManagementApi delete_case DELETE /cases/{caseId} Delete Case
CaseManagementApi delete_case_document DELETE /cases/{caseId}/documents/{documentId} Delete Document from Case
CaseManagementApi delete_nigo DELETE /cases/{caseId}/nigos/{nigoId} Delete Nigo
CaseManagementApi delete_nigo_document DELETE /cases/{caseId}/nigos/{nigoId}/documents/{documentId} Delete Document from Nigo
CaseManagementApi delete_task DELETE /cases/{caseId}/tasks/{taskId} Delete Task
CaseManagementApi delete_task_document DELETE /cases/{caseId}/tasks/{taskId}/documents/{documentId} Delete Document from Task
CaseManagementApi get_case GET /cases/{caseId} Get Case details
CaseManagementApi get_case_documents GET /cases/{caseId}/documents Get list of document in a case
CaseManagementApi get_case_nigo GET /cases/{caseId}/nigos/{nigoId} Get nigo in a case
CaseManagementApi get_case_nigos GET /cases/{caseId}/nigos Get list of Nigos in a case
CaseManagementApi get_case_task GET /cases/{caseId}/tasks/{taskId} Get task in a case
CaseManagementApi get_case_tasks GET /cases/{caseId}/tasks Get list of tasks in a case
CaseManagementApi get_cases GET /cases Get Case listing
CaseManagementApi get_nigo_documents GET /cases/{caseId}/nigos/{nigoId}/documents Get list of document in a task
CaseManagementApi get_task_documents GET /cases/{caseId}/tasks/{taskId}/documents Get list of document in a task
CaseManagementApi update_case PATCH /cases/{caseId} Update existing Case
CaseManagementApi update_nigo PATCH /cases/{caseId}/nigos/{nigoId} Update existing Nigo
CaseManagementApi update_task PATCH /cases/{caseId}/tasks/{taskId} Update existing Task
CustomIndexApi delete_index DELETE /indices/{indexType}/{indexKey}
CustomIndexApi index_folder_move POST /indices/{indexType}/move
CustomIndexApi index_search POST /indices/search
DocumentActionsApi add_document_actions POST /documents/{documentId}/actions Add document action
DocumentActionsApi add_document_retry_action POST /documents/{documentId}/actions/retry Retries failed document action(s)
DocumentActionsApi get_document_actions GET /documents/{documentId}/actions Get document actions
DocumentFoldersApi add_folder POST /folders Add document folder
DocumentFoldersApi delete_folder DELETE /folders/{indexKey} Delete document folder
DocumentFoldersApi get_folder_documents GET /folders Get document folders
DocumentOCRApi add_document_ocr POST /documents/{documentId}/ocr Perform document ocr
DocumentOCRApi delete_document_ocr DELETE /documents/{documentId}/ocr Delete document ocr
DocumentOCRApi get_document_ocr GET /documents/{documentId}/ocr Get document ocr content
DocumentOCRApi set_document_ocr PUT /documents/{documentId}/ocr Set document ocr result
DocumentSearchApi document_search POST /search Document search
DocumentSharesApi add_folder_share POST /shares/folders/{indexKey} Add folder share
DocumentSharesApi delete_share DELETE /shares/{shareKey} Delete folder share
DocumentSharesApi get_user_shares GET /shares Get user shared folders
DocumentTagsApi add_document_tags POST /documents/{documentId}/tags Add tag to document
DocumentTagsApi delete_document_tag DELETE /documents/{documentId}/tags/{tagKey} Delete document tag
DocumentTagsApi delete_document_tag_and_value DELETE /documents/{documentId}/tags/{tagKey}/{tagValue} Delete document's tag value
DocumentTagsApi get_document_tag GET /documents/{documentId}/tags/{tagKey} Get document tag by key
DocumentTagsApi get_document_tags GET /documents/{documentId}/tags Get document's tags
DocumentTagsApi set_document_tag PUT /documents/{documentId}/tags/{tagKey} Update document tag value(s)
DocumentTagsApi set_document_tags PUT /documents/{documentId}/tags Set document's tags
DocumentTagsApi update_document_tags PATCH /documents/{documentId}/tags Update document tags
DocumentTagsApi update_matching_document_tags PATCH /documents/tags Mass Update document tag(s)
DocumentVersionsApi delete_document_version DELETE /documents/{documentId}/versions/{versionKey} Delete document version
DocumentVersionsApi get_document_versions GET /documents/{documentId}/versions Get document's versions
DocumentVersionsApi set_document_version PUT /documents/{documentId}/versions Set version of document
DocumentWorkflowsApi add_document_workflow POST /documents/{documentId}/workflows Add document workflow
DocumentWorkflowsApi add_document_workflow_decisions POST /documents/{documentId}/workflow/{workflowId}/decisions Approve/Reject document in approval queue
DocumentWorkflowsApi add_queue POST /queues Add queue
DocumentWorkflowsApi add_workflow POST /workflows Add workflow
DocumentWorkflowsApi delete_queue DELETE /queues/{queueId} Delete queue
DocumentWorkflowsApi delete_workflow DELETE /workflows/{workflowId} Delete workflow
DocumentWorkflowsApi get_document_workflow GET /documents/{documentId}/workflows/{workflowId} Get document workflow
DocumentWorkflowsApi get_document_workflows GET /documents/{documentId}/workflows Get document workflows
DocumentWorkflowsApi get_queue GET /queues/{queueId} Get queue
DocumentWorkflowsApi get_queues GET /queues Get queues
DocumentWorkflowsApi get_workflow GET /workflows/{workflowId} Get workflow
DocumentWorkflowsApi get_workflow_documents GET /workflows/{workflowId}/documents Get list of documents in workflow
DocumentWorkflowsApi get_workflow_queue_documents GET /queues/{queueId}/documents Get list of documents in queue
DocumentWorkflowsApi get_workflows GET /workflows Get workflows
DocumentWorkflowsApi set_workflow PUT /workflows/{workflowId} Set workflow
DocumentWorkflowsApi update_workflow PATCH /workflows/{workflowId} Update workflow
DocumentsApi add_document POST /documents Add new document
DocumentsApi add_document_upload POST /documents/upload Add large document
DocumentsApi compress_documents POST /documents/compress Compress multiple documents into a .zip file
DocumentsApi delete_document DELETE /documents/{documentId} Delete document
DocumentsApi get_document GET /documents/{documentId} Get document
DocumentsApi get_document_content GET /documents/{documentId}/content Get document's contents
DocumentsApi get_document_id_upload GET /documents/{documentId}/upload Get url to update large document
DocumentsApi get_document_syncs GET /documents/{documentId}/syncs Get document syncs
DocumentsApi get_document_upload GET /documents/upload Get url to add large document
DocumentsApi get_document_url GET /documents/{documentId}/url Get document content url
DocumentsApi get_documents GET /documents Get Documents listing
DocumentsApi set_document_restore PUT /documents/{documentId}/restore Restore soft deleted document
DocumentsApi update_document PATCH /documents/{documentId} Update document
ESignatureApi add_esignature_docusign POST /esignature/docusign/{documentId} Create E-signature request
ESignatureApi add_esignature_docusign_events POST /esignature/docusign/events Add E-signature event
ESignatureApi get_esignature_docusign_config GET /esignature/docusign/config Get E-signature config
ESignatureApi set_esignature_docusign_config PUT /esignature/docusign/config Set E-signature config
ExamineObjectsApi get_examine_pdf GET /objects/examine/{id}/pdf Add Examine Pdf
ExamineObjectsApi get_examine_pdf_url GET /objects/examine/pdf Add Examine Pdf
OnlyofficeApi only_office_document_edit POST /onlyoffice/{documentId}/edit Edit onlyoffice document
OnlyofficeApi only_office_document_new POST /onlyoffice/new Create onlyoffice document
OnlyofficeApi only_office_document_save POST /onlyoffice/{documentId}/save Save onlyoffice document
PublicApi public_add_document POST /public/documents Public add document
PublicApi public_add_webhook POST /public/webhooks/{webhooks+} Public add webhook
RulesetsApi add_rule POST /rulesets/{rulesetId}/rules Add New Rule
RulesetsApi add_ruleset POST /rulesets Add New Ruleset
RulesetsApi delete_rule DELETE /rulesets/{rulesetId}/rules/{ruleId} Delete Rule
RulesetsApi delete_ruleset DELETE /rulesets/{rulesetId} Delete Ruleset
RulesetsApi get_rule GET /rulesets/{rulesetId}/rules/{ruleId} Get Rule
RulesetsApi get_rules GET /rulesets/{rulesetId}/rules Get Rules
RulesetsApi get_ruleset GET /rulesets/{rulesetId} Get Ruleset
RulesetsApi get_rulesets GET /rulesets Get Rulesets
RulesetsApi update_rule PATCH /rulesets/{rulesetId}/rules/{ruleId} Update Rule
RulesetsApi update_ruleset PATCH /rulesets/{rulesetId} Update Ruleset
SystemManagementApi add_api_key POST /sites/{siteId}/apiKeys Add API Key
SystemManagementApi delete_api_key DELETE /sites/{siteId}/apiKeys/{apiKey} Delete API Key
SystemManagementApi delete_opensearch_index DELETE /sites/{siteId}/opensearch/index Deletst site(s) OpenSearch index
SystemManagementApi get_api_keys GET /sites/{siteId}/apiKeys Get API Keys
SystemManagementApi get_configuration GET /sites/{siteId}/configuration Get site configuration
SystemManagementApi get_opensearch_index GET /sites/{siteId}/opensearch/index Get site(s) OpenSearch index settings
SystemManagementApi get_sites GET /sites Get site(s) access
SystemManagementApi get_version GET /version Get FormKiQ version
SystemManagementApi set_opensearch_index PUT /sites/{siteId}/opensearch/index Set site(s) OpenSearch index settings
SystemManagementApi update_configuration PATCH /sites/{siteId}/configuration Update site configuration
TagIndexApi index_search POST /indices/search
TagSchemaApi add_tag_schema POST /tagSchemas Add tag schemas
TagSchemaApi delete_tag_schema DELETE /tagSchemas/{tagSchemaId} Delete tag schema
TagSchemaApi get_tag_schema GET /tagSchemas/{tagSchemaId} Get tag schema
TagSchemaApi get_tag_schemas GET /tagSchemas Get tag schemas
UserActivitiesApi get_document_user_activities GET /documents/{documentId}/userActivities Get user activities
UserActivitiesApi get_user_activities GET /userActivities Get user activities
UserManagementApi get_groups GET /groups Get configured system group(s)
UserManagementApi get_users_in_group GET /groups/{groupName}/users Get users in a group
WebhooksApi add_webhook POST /webhooks Add webhook
WebhooksApi add_webhook_document POST /private/webhooks/{webhooks+} Add webhook
WebhooksApi add_webhook_tag POST /webhooks/{webhookId}/tags Add webhook tag
WebhooksApi delete_webhook DELETE /webhooks/{webhookId} Delete webhook
WebhooksApi get_webhook GET /webhooks/{webhookId} Get webhook
WebhooksApi get_webhook_tags GET /webhooks/{webhookId}/tags Get webhook tags
WebhooksApi get_webhooks GET /webhooks Get webhooks
WebhooksApi update_webhook PATCH /webhooks/{webhookId} Update webhook

Documentation For Models

Documentation For Authorization

Endpoints do not require authorization.

Author

support@formkiq.com