Differences

This shows you the differences between two versions of the page.

--- api [2026/04/07 03:30] – melon
+++ api [2026/04/07 16:39] (current) – melon
@@ Line 3: / Line 3: @@
 The MelonLand API is a programing interface you can use to access forum data on your site or in a program you are coding. All API calls return JSON standard data that can be parsed in JavaScript, PHP and all other languages.
-//**NOTE:** API data is cached for up to 60 seconds on the server, all data received may be 60 seconds out of date.//
+//**NOTE:** API data is cached for up to 120 seconds on the server, all data received may be 120 seconds out of date.//
 All API calls include an "ok" (true, false) value, ok will be true if the api call was successful!
 | **API Function** | **What it does** | **Parameters** |
+| [[https://forum.melonland.net/api.php?smileys|smileys]] | List forum smileys | -- |
 | [[https://forum.melonland.net/api.php?memberNames|memberNames]] | Display names associated with member IDs | ''id'' (filter to member ID) · ''username'' (include eSite username) |
-| [[https://forum.melonland.net/api.php?memberWebsites|memberWebsites]] | Linked profile websites | ''id'' (filter to member ID .. same for below!) |
+| [[https://forum.melonland.net/api.php?memberWebsites|memberWebsites]] | Linked profile websites | ''id'' (filter to member ID) - **most id fields accept lists id=1,53,2** |
 | [[https://forum.melonland.net/api.php?memberAvatar|memberAvatar]] | Profile avatar filenames | ''id'' |
 | [[https://forum.melonland.net/api.php?memberJoinDate|memberJoinDate]] | Member registration dates | ''id'' |
@@ Line 17: / Line 18: @@
 | [[https://forum.melonland.net/api.php?spaceHey|spaceHey]] | Linked profile SpaceHey names | ''id'' |
 | [[https://forum.melonland.net/api.php?itch|itch]] | Linked profile itch.io names | ''id'' |
-| [[https://forum.melonland.net/api.php?artifacts|artifacts]] | List artifacts | ''id'' · ''artifact=3'' (artifact id) · ''locked=0'' (exclude) · ''unlocked=0'' (exclude) |
+| [[https://forum.melonland.net/api.php?artifacts|artifacts]] | List artifacts | ''id=22,26'' (artifact id) · ''locked=0'' (exclude) · ''unlocked=0'' (exclude) · ''page''  |
-| [[https://forum.melonland.net/api.php?artifactHistory=|artifactHistory]] | Transfer history for artifacts | ''artifactHistory=906,42,88'' (comma-separated artifact IDs) |
+| [[https://forum.melonland.net/api.php?memberArtifacts|memberArtifacts]] | Lists artifact IDs related to one member | ''id'' (member - list owned by) · ''created'' (member - list created by) - only use one! |
+| [[https://forum.melonland.net/api.php?artifactHistory=|artifactHistory]] | Transfer history for listed artifacts | ''artifactHistory=906,42,88'' (comma-separated artifact IDs) |
 | [[https://forum.melonland.net/api.php?galleryImages|galleryImages]] | Gallery image listings | ''id'' · ''cat'' · ''mature=1'' · ''limit'' (max 100) · ''page'' (grouped by page) |
 | [[https://forum.melonland.net/api.php?galleryCategories|galleryCategories]] | Gallery categories | ''id'' (member id - only show cats this member has art in) |