| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| api [2026/04/07 04:47] – melon | api [2026/04/07 16:39] (current) – melon |
|---|
| 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. | 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! | 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** | | | **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?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?memberAvatar|memberAvatar]] | Profile avatar filenames | ''id'' | |
| | [[https://forum.melonland.net/api.php?memberJoinDate|memberJoinDate]] | Member registration dates | ''id'' | | | [[https://forum.melonland.net/api.php?memberJoinDate|memberJoinDate]] | Member registration dates | ''id'' | |
| | [[https://forum.melonland.net/api.php?itch|itch]] | Linked profile itch.io 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=22,26'' (artifact id) · ''locked=0'' (exclude) · ''unlocked=0'' (exclude) · ''page'' | | | [[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?memberArtifacts|memberArtifacts]] | Lists artifacts related to one member | ''id'' (member - list owned by) · ''created'' (member - list created by) - only use one! | | | [[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?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?galleryImages|galleryImages]] | Gallery image listings | ''id'' · ''cat'' · ''mature=1'' · ''limit'' (max 100) · ''page'' (grouped by page) | |