Please contact your local IDS distributors for first level support in your language. For a list of IDS distributors worldwide please go to our website http://www.ids-nxt.com.
IDS NXT: REST interface 2 Symbols and hints This symbol indicates hints with useful information for better understanding and using features and functions. This symbol indicates important warnings for product safety to prevent damage. March 2021...
Set important device parameters and update The default password for each user class is "ids". When you log in for the first time, you must change the password to be able to log in. If you log in with the administrator profile, you can change the passwords for the user classes "Service"...
IDS NXT: REST interface Type Qt/C++ equivalent Integer qint64 Boolean bool Double double 3.5 Implemented services Variable paths are specified in angle brackets (e.g. <appname>) and match [a-zA-Z]+[_a-zA-Z0-9-]* The (partially exemplary) response to an OPTIONS request is shown here. GET, DELETE etc. relate to the possible HTTP methods for the specified address. The JSON objects in the level below specify the permitted or available MIME types.
IDS NXT: REST interface 4 User control Creating and deleting users, and changing group association is currently deactivated on the device side. · /users · /users/<existing-username> 4.1 /users · OPTIONS · "GET": { "application/json": { "Allowed": true, "Description": "Receive user list", "Values": {...
Page 10
IDS NXT: REST interface "Objects": [ "admin", "writeparam", "readparam", "modvapp" "PATCH": { "application/x-www-form-urlencoded": { "Allowed": true, "Description": "Modifies the user", "Values": { "Password": { "Description": "New password", "Type": "String" Comments Objects are group names and have no REST answers. March 2021...
IDS NXT: REST interface 5 Device events · /events · Server sent events · Event syntax · Restrictions 5.1 /events · Events can be transferred using the device event resource "/events". The client makes a one-off GET request for /events and then receives the events in the body of the response. Chunked transfer encoding is used to enable the events to be sent regardless of the time of the GET request.
IDS NXT: REST interface 5.2 Server sent events In addition to the proprietary interface (deprecated), the events can also be requested using SSE. To do this, the request must include an HTTP header (Accept: text/eventstream) and the events (see Event syntax) are then transferred in the data block.
IDS NXT: REST interface Objects [ "PATCH": { "application/x-www-form-urlencoded": { "Description": "Update the internal flash settings.", "Values": { "AutoDuration": { "Description": Automatic flash duration configuration based on exposure time and sensor", "Type": "Boolean" "Delay": { "Description": "Flash delay in microseconds", "Range": {...
Page 33
IDS NXT: REST interface · If necessary, set a delay · Inverted = true Automatic flash (depending on model) · AutoDuration = Activates (true) or deactivates (false) the automatic control of the flash output. If "AutoDuration" is activated, the manual value under "Duration" has no effect.
IDS NXT: REST interface NOTICE! Unlike the IDS NXT cockpit, the PATCH command via the REST interface does not check if the IP address is within the permitted range. Therefore, you can also set an invalid IP address, which means that you cannot communicate with the camera any more. Do not set an invalid IP address, e.g.
IDS NXT: REST interface "Mandatory": false, "Type": "String", "Unit": "RFC2822" "Objects": [ "identifier1", "identifier2", "…" Note: Filtering by sender and severity is currently not possible. Comments · Objects are available signals (<id>). · Source can be either "system" or a VisionApp (e.g. "autoset").
Page 44
IDS NXT: REST interface "Timestamp": { "Description": "Time of signal creation", "Type": "Timestamp", "Unit": "RFC2822" "image/png,image/bmp,image/jpeg": { "Description": "Return event's image, not always possible (may return 404)", "Parameters": { "MaxHeight": { "Description": "Maximal height of image.", "Mandatory": false, "Type": "Integer"...
IDS NXT: REST interface "Type": "Integer" "Objects":[ "change" Note: The ID and number of counters can vary and is dynamic. The ID "LastReset" is not a counter ID; it specifies the time of the last counter reset. There are some predefined identifiers that can be used for calculations etc. (if they are present) in the client.
IDS NXT: REST interface 14 Support file /support · OPTIONS · "GET": { "application/x-compressed-tar": { "Description": "Get this file!" A support file can be retrieved using a GET /support. This requires administrator authorizations. The support file contains the following data: ·...
IDS NXT: REST interface 16 Vision app list Vision app identifiers must follow these guidelines: · Maximum 100 characters · Only letters, numbers and underscores A-Za-z0-9_ · Not starting with a number · Starting with underscore is reserved for the system. Although this is possible, it is not recommended.
IDS NXT: REST interface "rs232gateway" Comments Objects are all vision apps (not just those activated!) 16.3 /vapps/activated/<vapp> · OPTIONS · DELETE · "DELETE": { "<none>": { "Description": "Deactivate the vision app.", "Parameters": { "Temporary": { "Description": "If true, the vision app is deactivated temporarily only.",...
Page 53
IDS NXT: REST interface "PUT": { "application/vapp": { "Description": "Updates/installs the vision app" Body for the PUT must be a vision app (*.vapp). March 2021...
IDS NXT: REST interface "Objects": [ "PATCH": { "application/x-www-form-urlencoded": { "Description": "Modify VApp-Configurables.", "Values": { "a_header": { "Brief": "Header of result output", "Description": "Header of the result output. Special characters can be set with \\xx where xx is the corresponding hexadecimal value (ASCII).", "Title": "Header",...
IDS NXT: REST interface 17.4.3 /vapps/<vapp>/files/<file>/data · OPTIONS · (Available if ConfigurableFile is set to "Readable"). · (Available if ConfigurableFile is set to "Writable"). · DELETE (Available if ConfigurableFile is set to "Deletable"). The MIME type (e.g. image/jpeg) depends on the ConfigurableFile and therefore can be any type. Title, Brief, Description are only specified if they are set and not blank.
IDS NXT: REST interface "Description": "The specific result source", "Range": [ "<string>" "Type": "String" "Title": { "Description": "Title of the result sink", "Type": "String" "Type": { "Description": "Type of the result sink", "Type": "String" "VApp": { "Description": "The result source's vision app", "Range": [...
IDS NXT: REST interface Comments · The dummy object has been incorporated to enable the OPTIONS for a list entry (/vapps/<vapp>/resultsources/list/<key>) to be requested without it having or exist or be explicitly selected. No GET is permitted here. · Like the Configurables, ResultSources can have ranges ("Range", "WarningRange..", "ErrorRange..") and units.
IDS NXT: REST interface Comments · /vapps/<vapp>/resultsources/last returns the last result. · Like the Configurables, ResultSources can have ranges ("Range", "WarningRange..", "ErrorRange..") and units. Title, Brief and Description can also be specified. · Unfortunately, the complex response to a GET is not shown in full here. To see it, refer to the following section.
IDS NXT: REST interface version - A - - I - Action information Image vision app JPEG Avatar - B - Input Bild invert status - C - Interface Camera RS-232 color gain - L - exposure time frame rate...
Page 72
IDS NXT: REST interface Signal update detail list Statistics 45, 46 Support file System details status - T - Trigger delay hardware prescaler software Boolean Double Integer String StringList - U - Unit display localization User authentification create delete list...