The SAYMON API is implemented as a RESTful service. It uses standard HTTP methods for requests and returns responses in the JSON format. The API allows you to perform the same operations as you can do using a web interface. For instance, you can get objects' current states and their state history, write data to objects without using agents, work with incidents, create classes, and many others.
The documentation contains a list of all methods available in the SAYMON API. The methods are divided into groups, such as Authentication, Objects, etc. Each group has a description of use cases for its methods. An article covering a particular API method consists of:
method verb (
method URL (e.g.
request libraries accordingly.
The code samples are implemented as self-sufficient as possible. The only parameters you need to provide to make them work are your login credentials and a SAYMON hostname. In some cases, some auxiliary parameters (such as an object or user ID) are required.
A recommended way to use this documentation is to read about methods' permissions first, then learn Authentication schemes, and after that read articles about particular API methods and their applications.
Also, you might find useful an article about response errors. The article contains a description of errors you may encounter while making requests and possible ways to address these errors.