echolotl.lol backend API thing

Documentation

• GET /spotify

  Gets echolotl's current playing song on Spotify.

  Gets echolotl's current playing song on Spotify.

  Rate Limit

  15 requests over 1 minute

  Returns

  200 OK

  Provides a stripped down version of Spotify's current playback information.
  Omitted fields include: actions, device, repeat_state, shuffle_state, and context.

  204 No Content

  Returns if echolotl is not currently playing anything on Spotify.
• GET /status

  Gets echolotl's latest status.

  Gets echolotl's latest status.

  Rate Limit

  15 requests over 2 minutes

  Returns

  200 OK

  Returns the latest status object.

  Example

  {
    "text": "sleepy",
    "emoji": "😴",
    "createdAt": 1741553075123
  }

  204 No Content

  Returns when no status has been set yet. (Which probably means that the database got deleted. Whoops!)
• GET /status/history

  Gets recent status history.

  Gets recent statuses, newest first.

  Query Parameters

  limit (optional number): Number of statuses to return. Defaults to 10.

  Rate Limit

  15 requests over 2 minutes

  Returns

  200 OK

  Returns a list of statuses and the count returned.

  {
    "total": 2,
    "statuses": [
      {
        "text": "coding",
        "emoji": "🧠",
        "createdAt": 1741553075123
      },
      {
        "text": "lunch",
        "emoji": null,
        "createdAt": 1741549075123
      }
    ]
  }

  204 No Content

  Returns when no statuses are available.
• POST /status lock

  Sets a new status.

  Creates a new status entry.

  Headers

  Authorization: required passkey token. (Defined in server config)

  Body

  {
    "text": "string (1-100 chars)",
    "emoji": "emoji (optional, nullable)"
  }

  Rate Limit

  15 requests over 2 minutes

  Returns

  200 OK

  Returns a confirmation text string with the new status.

  401 Unauthorized

  Missing Authorization header.

  403 Forbidden

  Provided passkey is invalid.