App - Development: Rest Interface
This REST API documentation is your starting point for accessing the matterial app.
Introduction
The matterial API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON and XML request bodies (payload), returns JSON, XML or plain text responses, and uses standard HTTP response codes.
Before you start using the API you should be familiar with the matterial application and the concepts behind it. It is especially important to understand how matterial treats documents, versions and languages.
Quick Start Guide
Sample clients
C# Client Library
A full C# client library wrapping the REST API is documented here:
Matterial Core C# Client Library
SaaS vs. on premise
Matterial is a cloud-based software but it can also be installed on premises. Some of the API features are only available with the SystemAccount permission. This permission is only available for on premise installations.
API Reference
Breaking changes and additions are documented within the API Changes.
Authentication
The authentication requests are used to logon to matterial using different methods, like user and password authentication, Google OAuth or different other methods.
Document
The document interface is probably the most comprehensive interface of matterial. It includes all functionalities around documents. Before you use it, you should be familiar with the way matterial manages documents. You will find all the necessary information here: Working with documents
Temp File
The Temp File API is used to handle upload of files to matterial.
Category
Matterial supports categorising documents in a very powerful way. This API lets you manage, create update and follow categories.
Comment
You can add Comments to documents and this API lets you manage them.
Person
The person API allows you to manage user accounts, profile settings and export of user data.
Role
Permissions are a core feature of matterial. It is based on roles.
Task
Matterial includes workflow-type features and the Task API lets you handle that part of the application.
Client (On-Premise Only)
If matterial is installed on premise, it is multi-client capable which means you can create and manage multiple clients. A Client represents a separate set of data like documents persons, etc. within the same material instance. A person can switch easily between clients without having to change the instance.
Instance management
The Instance Management interface allows you to configure instance settings and manage/create instances.
Please Note
Most of the requests require the SystemAccount permission which is only available for on premises installations.
Activity
Licence
Language
Add and manage languages.
Skin
Possibility to overwrite styles.
Conversion
The matterial server is able to convert back and forth between Html and Markdown format. You can use the API to convert matterial documents.
Notification
Handle notification settings and configure how users should be notified.
Tracking
The Tracking API allows you to access statistic data of the matterial instance.
Version
Get version information about the matterial server.
Changelog
Get the changelog of the application.
Test
The famous “Hello world” test.
Information
Entity types
A list of the constants of entity types.
EntityTypes
Status Codes
Matterial status codes.
StatusCodes
