API
Last Updated on October 24th, 2022
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:
https://api.empanadas.io/v1/jeff.phpAll Messages Endpoint:
Requires an API Key from your Empanadas.io account.
https://api.empanadas.io/v1/jeff_history.php?apikey=YOUR_SECRET_HEREThe 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:
https://api.empanadas.io/v1/stats.phpAnnouncements 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:
https://api.empanadas.io/v1/updates.phpTo 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.