This page was last updated 2025-04-26.
Source Code & Issue Tracker: github.com/enstrayed/enstrayedapi
Multiple API endpoints are being rewritten/added, especially relating to authentication & authorization, as part of a database change to Postgres. These changes are being made in the new-db branch.
Returns whatever I'm listening to via the Last.fm API in JSON. If ?format=html is used in the URL it will return the same but in HTML. If nothing is playing the JSON response will just have "playing": false.
Beta verison of the /nowplaying endpoint. This version will change frequently but presently queries my Jellyfin for what I'm listening to and will return that as JSON. If ?format=html is appended to the URL it will return the same but in HTML. Each line in the HTML response has a class nowPlayingLine[1-4] that can be used to style the text using CSS. See libnowplaying.js:63 for the format of the result.
Retrieves, creates or deletes entries for the etyd.cc URL shortener. Replace * in the URL for the target of the request.
Required Headers (POST, DELETE):Authorization: A token with the etyd scope{
"url": "urlValue"
}Sends an email to the specified recipient, intended for application & automation use.
Required Headers:Authorization: A token with the mailjet scope{
"recipient": "recipientEmailHere",
"subject": "emailSubjectHere",
"message": "emailBodyHere"
}Returns the IP, country and Cloudflare ray of the request in JSON.
Returns all request headers in JSON.
Returns JSON with the username of the token owner as well as what scopes the token has access to.
Redirects the user to ECLS to login. The state parameter can be used to specify how the login flow will behave. The accepted "states" are:
redirect - Redirects the user to a page after logging in. This paramter requires the destination paramter to also be set with the URL the user will be redirected to.display - Displays the generated token to the user after login. Currently, this still writes the new token to the APIToken cookie, though this is planned to change.close - This will close the page after logging in. This requires the page to be opened with JavaScript otherwise it will not automatically close.Invalidates the token used to access the endpoint.
Internal Use Only. This is the endpoint used by ECLS to finish the login flow. It will write the newly created token to the APIToken cookie as well as performing the action set by state, see login endpoint.