Maytech Public Documentation
Space shortcuts
Skip to end of metadata
Go to start of metadata


The Quatrix API reference will walk you through a set of file sharing features that you can use in your own app. It explains the basics for creating API calls, covers authentication methods, provides design principles for API calls and displays error codes. 

Overview

Quatrix is secure cloud file sharing platform with centralised administration, easy-to-use interface, and SFTP access.  You can use it for sharing and acquiring files securely and reliably online. It combines fast file transfer, convenience and flexibility of use and premium-grade security features. Check out Quatrix homepage for details.


Quatrix API documentation is intended for developers who want to write applications that interact with Quatrix.  

Our goal is to simplify adding file sharing features to your application so that you can focus on integrating the core features to your product.


        Contents



Before you start

You need to have a Quatrix account to access Quatrix APIs. If you haven’t registered yet, set up a free trial account here

If you are not familiar with Quatrix features, read the introductory page about Quatrix on our website, learn about features here and explore the user interface before getting down to code. 

Authentication

Quatrix maintains state throughout the session, for that reason you need a unique API key for each session. You can use HTTP basic authentication to authorize the requests which means you can simply send the user name and password associated with the account.  If you create a basic authentication header manually, stick to the following rules:

  • The user email and password should be combined with a single colon (:) e.g. 

    test@example.com:qwerty
  • The resulting string is encoded using a variant of Base64.
  • The authorization method (e.g. Basic) should be prepended to the encoded string and separated with space. This is further used as a value for Authorization field. e.g. 

    Authorization: Basic dGVzdEBleGFtcGxlLmNvbTpxd2VydHk=

Follow these steps to authorize with Basic authentication;

  1. Open Swagger, paste your URL (https://yourcompany.quatrix.it/swagger/quatrix.json/) into the blank field and click on the Explore button. This will display the list of available resources. 



  2. Click on the Authorize button that will open Available authorizations window, fill in your user name and password in Basic authorization section and press the Authorize button.

  3. Go to Auth resource and make GET /session/log in API call to retrieve a session ID = API key. See the screenshot.
  4. Go back to the Authorize button and paste the session ID into the Value field in the API key section.

  5. Click on the Authorize button.

Once authorized, you can make any call by clicking first on the Try it out button and then on the Execute button that will provide results in the response. 

Subsequent API calls are authorized using this key. The key is valid/active for 15 minutes since the last API action. If there was no activity during this period, the API key will expire, and the user must generate a new one. 

When you are authorized, you can make almost all API calls, however there are some that require no authorization e.g. containing security: [] GET /account/logo.

Design

We use RESTful design patterns for URLs and our API methods support GET and POST requests. Each method operates on a certain resource (view the list of resources below) and produces a JSON response. 


ResourceDescription
AuthAuthenticate Quatrix account
AccountGet general information about the current account account
LanguageGet details about account language
ContactCreate and manage contacts
PGPGenerate and manage PGP keys
GroupGet information about users and contacts
FileRetrieve and modify files/folders (hereinafter files)
UploadFile uploading
Password resetReset password for existing users
Preview

Preview photos, videos or files

ProfileUpdate profile information of the user
MFAEnable and disable MFA
Project folderCreate and manage project folders
Site settingsManage service settings
UserCreate and manage users
WidgetSet the widget
ShareCreate shares, quick links, file sharing requests
Activity logTrack activity history
ServiceGet information about the service
AutomationCreate and administer automatic rules
InboxActivity tracking of a logged-in contact
SSH keyCreate and manage SSH keys
BillingAccount upgrade


You can try out our APIs using Swagger where you can dig deeper into each resource and explore related endpoints with possible HTTP methods. 


Base URL

The base URL for API calls should be formatted in the following way: 

https:// {YourQuatrixSiteName}.quatrix.it/api/1.0/

The current API version is 1.0.

Errors

Conventional HTTP response codes are used to indicate the success or failure of an API request.  When an error occurs, it contains an error code and the description so that you can easily identify the problem and solve it.

In general, we use codes in the range of 2хх to indicate the success of the request. E.g. 200 – login success response. Codes in the range of 4хх display the API request failure due to e.g. 400 – parameter error, or 401 - CAPTCHA is wrong.   

We use the following model to display an error where the message displays general information about an error, and details specifies additional information about it. 

{
  "msg": "string",
  "code": 0,
  "details": {}
}

The table below lists codes with their general descriptions.

Code

Error Detail

-1Unknown error
10Bad parameter value
11Missing parameter
12Bad host name
20Not found
21Not supported
30Object exists
31User exists
32Contact exists
40Operation not supported
50Restriction error
51PGP disabled error
60Expired error
61Not allowed without set up 2FA
70Not allowed
71Not allowed without set up 2FA
72Not allowed without password
73Not allowed without PIN
74Not allowed without CAPTCHA
75Not allowed without Basic Auth
76Not allowed IP restriction
77Current IP not in IPR masks
78Widget CAPTCHA required
79Widget file limit
80Deactivated
81Inactive
82Deactivated role
83Failed 2FA
84Failed PIN
90No data
91Widget doesn't exist

Support

If you have any problems with integration, code or something urgent, feel free to contact us via phone or email.  

Int & UK: +44 (0) 1892 861 222 | USA: 1 800 592 1906

  • No labels