API

Jeff the Giraffe

Jeff fetches his daily messages from a JSON file that contains:

• number (int) The ID of Jeff's message. This number will go up by 1 each time it changes.
• use_image (boolean) True if a Jeff image is present, false if not.
• image (string) The file name of Jeff's image. (Ex: "jeffhearts.gif" would direct to empanadas.io/Content/Images/Jeff/jeffhearts.gif)
• message (string) The message Jeff will use! (Note, this will sometimes contain Unicode/HTML tags)
• button (boolean) True if there is a clickable button under Jeff, false if not.
• button_text (string) The text displayed on the button if above is true.
• button_href (string) The link that the button points to.
• button_target (string) Usually set to _blank to open in a new tab. Tells browser how to open link.
• time (string) The time as a string from the initial post.
• timestamp (long) The time from the initial post as a long.

Current Message Endpoint:

All Messages Endpoint:

Requires an API Key from your Empanadas.io account.

The JSON formatting for the jeff_history endpoint works by using the message ID's at the start of each path. The timestamp and clientid argument are kept outside of the main message ID scope. Your clientid is a small unique and public identifier linking your Empanadas.io account to your API keys. All Empanadas.io users are able to generate up to 5 API Keys for their account here. Never share your API Secret with anyone. We may randomly change your API keys for security in the future.

Global Stats

Empanadas.io can return a JSON file that sums up all data from all accounts.

• Result
• result (boolean) A true/false if the database/request was successful.
• Data
The data from all member accounts combined
• Total_Peppers All users current peppers + spent peppers.
• Total_Spins Total manual (clicked) spins in the Spin Game.
• Total_Flappy Total number of Flappy Empanada games played.
• Total_Ascentions Total number Ascentions made within the game.
• Total_Burnt Number of burnt empanadas clicked by all users.
• Other
• time (long) The time the query started (in miliseconds).
• query_ms (int) How long the database lookup took to complete.

Endpoint:

Announcements API

Get the latest updates from Empanadas.io with our update API endpoint:

• id (string:6) A random ID assigned to each update posted.
• title (string) The headline that shows at the top of each post.
• content (string) The file name of Jeff's image. (Ex: "jeffhearts.gif" would direct to empanadas.io/Content/Images/Jeff/jeffhearts.gif)
• date (string) The difference in time as a string from the post to today. (Ex: "2 days ago")
• edited (false / string) Returns false if not edited, otherwise it gives a string of how long ago it changed.
• author (array) Returns the account data from who posted the update.
  username (string) The username of who posted the update.
  uuid (string) The account UUID of the author.
  is_admin (boolean) Is the author currently a site admin?
  pfp (string) The realitive profile picture path for the author.
  default_pfp (boolean) True if no profile picture is set for the author.
• found (boolean) Does the post with this page/id param exist?
• last_checked (long) The UNIX time from when the database updated this page.

Endpoint:

To grab older posts, add a ?page parameter to the URL. I.E api.empanadas.io/v1/updates?page=3

System Status API

To prevent our status page from going offline when our origin server does, we use a 3rd party service to monitor and report incidents and outages. We can not see or monitor any API requests made to these endpoints. Seperate privacy policies, usage limits, and terms do apply.

You may view the seperate API for our status page here.

Helpful Tips

We give NO GUARANTEE that these methods won't have breaking changes. Basically, we want you to know that we may abruptly update our APIs, change their paths, change what they return, change how much they return, or some other form of change that could result in whatever calls you make to our services to break your application. By using our API, you understand this side-effect. We will try our best to bump the v number when breaking changes are made. At the moment v1 is the latest version. Directory listing is enabled on our api sub-domain, so feel free to use this in finding what you're looking for!

Request Limits

Since all of our APIs are cached on a CDN for 2 hours: All of our public API requests have no request limits. Should you suspect your applications traffic will exceeding normal expectations, we encourage you to implement caching techniques accordingly. Should you abuse our services, your access to our website and API will be revoked accordingly.

Questions About Our APIs?

Need help? Have a question? Join our discord or fill our our contact form and our lovely Empanada team would be more than happy to answer any of your questions.