The changes for each individual beta release can be seen here
-
⚠️ Breaking Enums are now serialized as strings, check the documentation for concrete updates. Please note, that not everything might be updated correctly⚠️ -
Added support for the Livestack plugin (>= 1.0.0.9)
-
livestack/start
to start the livestack -
livestack/stop
to stop the livestack -
livestack/image/{target}/{filter}
to get the current stacked image for a given filter and target -
STACK-UPDATED
event in the websocket added, to notify when a new image is available -
Added
waitForResult
toframing/slew
-
Added
version
to the documentation, it was always there just not documented -
Added
application/plugins
to get a list of installed plugins -
Added a 1s delay to the
IMAGE-SAVE
event to give NINA a bit more time to finish up the image -
image/{index}
now automatically retries the image retrieval 10 times with a 200ms delay between each try, if it fails to load the image (because it is in use for example) -
Fixed solving a capture image
-
Fixed an issue where the slew failed if no image was loaded in the framing assistant. An image is now automatically loaded
framing/determine-rotation
added to determine the rotation from the cameracamera/set-binning
added to set the binning of the camera, the binning mode has to be supported by the cameracamera/capture
:- URL parameter
omitImage
added to ignore the captured image, use if only the platesolve result is of interest - URL parameter
stream
added to stream the image, content type will be either image/jpg or image/png - URL parameter
waitForResult
added to wait for the capture to finish and then return the result. All parameters which you would normally use together withgetResult
will apply here as well
- URL parameter
- Added
stream
parameter toimage/{index}
to stream the image, content type will be either image/jpg or image/png - Added
stream
parameter toapplication/screenshot
to stream the image, content type will be either image/jpg or image/png - New Websocket Events:
FOCUSER-USER-FOCUSED
AUTOFOCUS-FINISHED
API-CAPTURE-FINISHED
is sent, whencamera/capture
finishes
mount/flip
added to perform a meridian flip, the flip will only be executed if it is neededmount/slew
slews the mount to the specified ra and dec anglesdome/set-follow
to start or stop the dome following the mountdome/sync
to start a sync of mount and scopedome/slew
to slew the dome to the specified azimuth angle (degree)DOME-SLEWED
andDOME-SYNCED
added as new events in the websocket
guider/start
now accepts the parameter calibrate to force a calibration (true / false)- Guider info now contains a State field indicating what the guider is currently doing
guider/clear-calibration
added to clear the current calibrationguider/graph
to get the last n guide steps as configured on the guide graph in NINA (in NINA you can set x to be 50, 100, 200 or 400)
- Added query parameter
skipRescan
to all connect endpoints, which can be used to skip the rescanning process resulting in a faster connection - Some websocket events now include more information:
FILTERWHEEL-CHANGED
includes the previous and new filterFLAT-BRIGHTNESS-CHANGED
includes the previous and new brightnessSAFETY-CHANGED
includes the new status
- Added
factor
,blackClipping
,unlinked
parameters toimage/{index}
to configure the stretch parameters
⚠️ Breaking Removed support for the deprecated v1 api⚠️ - Added more endpoints to
flatdevice
:flatdevice/set-cover
to open or close the coverflatdevice/set-light
to toggle the light on or offflatdevice/set-brightness
to change the brightness of the flatpanel
- Added more events regarding the flat panel:
FLAT-LIGHT-TOGGLED
FLAT-COVER-OPENED
FLAT-COVER-CLOSED
FLAT-BRIGHTNESS-CHANGED
- Added
sequence/set-target
to update the target in a target container - The server now automatically picks the next available port to launch the api
- Implemented IMessageBroker for cross Plugin communication. Use Topic
AdvancedAPI.RequestPort
to request the port the api is running on, subscribe toAdvancedAPI.Port
to recieve the answer. The port is directly written into Content
I heavily advise everyone still using V1 to start using V2 as V1 is now deprecated and will be removed with the next minor version! V2 will probably stay for a longer time now, I made some changes behind the scenes that will make it easier to add new features without breaking older versions.
The documentation for the api and the websockets will be hosted externally from now on
- It is now possible to add the
Access-Control-Allow-Origin: *
header to make requests via javascript without proxies possible. This does pose a security vulnerability though, so make sure you only enable it when you need to. A proxy may be better suited when in production. - Eventwatchers are now started independently of the api, therefore Events can still be retrieved using event-history even if the api wasn't running before.
⚠️ Breaking Connection events in the websocket are now seperated into connected and disconnected⚠️ ⚠️ Breaking Changed the structure of a profile response⚠️ ⚠️ Breaking Removed the description field from a sequence response, added more specific fields for each item⚠️ ⚠️ Breakingsequence/start
will now return an error if the sequence is already running⚠️ ⚠️ Breaking Image (history) now returns an error when there are no images available⚠️ ⚠️ Breaking Removed Id field from image-history response⚠️ - Added a new websocket for controlling TPPA and getting the current error in realtime
- Framing Assistant is now supported:
- Set the coordinates in the framing assistant
- Slew to coordiantes (optionally with center or rotate)
- Set desired rotation
- Add focuser move, info contains AvailableFilters field, added filter changing using the names from AvailableFilters, filter-info returns info about a given filter
- Autofocus can be cancelled (only if it was started using the api)
- Add telescope homing and tracking modes
- Add camera cooling, warming and dew heater control
- Add
TargetTemp
andAtTargetTemp
to CameraInfo - Added a gain field to capture
- A lot more events in the websocket, see the documentation for a list of all events
- GuiderInfo now includes the last guide step with raw distance
- The Sequence json is now more sophisticated with additional fields for most sequence items
- Added Conditions (global ones too) and triggers to the sequence json
- Added
sequence/reset
to reset the progress of a sequence - When retrieving images, you can now specify
scale
(0.1 to 1) to scale the image down while preserving its aspect ratio - Added the field
ImageType
to the IMAGE-SAVE Event and image-history - All Image Types (LIGHT, DARK, BIAS, FLAT, SNAPSHOT) now raise an IMAGE-SAVE event
framing/set-source
addedcamera/set-readout
added to set the readout modeversion
now returns the Plugin Version instead of an Independent Version number