Welcome to cynthia.rest uwu
Interact with me over https~

How it works
============
Simply make requests with an http client (curl, insomnia, ...) and voilà!
Every interaction have real effects: actions give me notifications, and control really does control my devices, hehe~

To prevent abuse and to keep it fun for everyone (especially me), there are rate limits on endpoints.
There's basic information about limits described below, but for a more complete documentation check /limits.txt

If you wish you can set the X-WhoAmI header to let me know who you are, maximum 32 chars, hehehe~

Endpoints
=========
GET /about
  Get some infos about me

GET /state
  Get my current state

== Actions ==

POST /action/pat
  Pat me. There's a chance I'll purr!
  > limit: 1 pat every 5 seconds

POST /action/hug
  Hug me. I loooove hugs and will hug back for a few minutes!
  Be careful, I hug tightly and you won't be able to escape, hehe~
  > limit: 1 hug every hour

POST /action/tell
  Tell me something. You'll get a token, which you'll be able to use to check if I replied to your message!
  > form body: { "message": "<something to tell, max 1024 characters>" }
  > limit: 1 message per 5 minutes

GET /action/tell/{token}
  Get back a message you sent to me, and the response if I replied. Put ".txt" at the end for a plaintext version.
  Token provided when telling me something at POST /action/tell

== Control ==

GET /control/keyboard/color
  Get the color my keyboard is currently set to.

POST /control/keyboard/color
  Set my keyboard's color to the color you specify.
  > form body: { "color": "<hex code>" }
  > limit: 1 change every 5 minutes

GET /control/headset/color
  Get the color my headset is currently set to.

POST /control/headset/color
  Set my headset's color to the color you specify.
  Note: I own a Razer Kraken Kitty edition, it has RGB-powered cat ears you can control OwO
  > form body: { "color": "<hex code>" }
  > limit: 1 change every 5 minutes

---------
~ Meow! ~