Skip to content

Latest commit

 

History

History
463 lines (410 loc) · 17.6 KB

File metadata and controls

463 lines (410 loc) · 17.6 KB

Documentation — lolzteam-api-java

Full method reference for the LOLZTEAM Forum and Market API Java client.

Client Configuration

Method Description Default
LolzteamClient.create(token) Create client with defaults
.builder(token) Create builder for fine-tuning
.proxy(url) Shared proxy for Forum and Market None
.forumProxy(url) Proxy for Forum API only None
.marketProxy(url) Proxy for Market API only None
.maxRetries(n) Max retry attempts 5
.baseDelayMs(ms) Initial backoff delay 1000
.maxDelayMs(ms) Max backoff delay 60000
.timeout(duration) Request timeout 30 sec
.forumBaseUrl(url) Custom Forum API URL https://prod-api.lolz.live
.marketBaseUrl(url) Custom Market API URL https://prod-api.lzt.market
.forumRateLimit(rpm) Forum rate limit (req/min) 300
.marketRateLimit(rpm) Market rate limit (req/min) 120
.marketSearchRateLimit(rpm) Market search rate limit 20
.noRateLimit() Disable rate limiting
.onRetry(callback) Retry callback

Error Types

Type Description
LolzteamException.HttpException Network error (timeout, DNS, connection)
LolzteamException.JsonException JSON parsing error
LolzteamException.AuthException 401 Unauthorized
LolzteamException.ForbiddenException 403 Forbidden
LolzteamException.NotFoundException 404 Not Found
LolzteamException.RateLimitedException 429 — all retry attempts exhausted
LolzteamException.RetryExhaustedException All retry attempts exhausted (502/503/504)
LolzteamException.ApiException Other HTTP errors from API
LolzteamException.ConfigException Configuration error

Code Generation

Generated files:

  • lolzteam-api/src/main/java/com/lolzteam/forum/ForumApi.java — Forum API methods (151 endpoints)
  • lolzteam-api/src/main/java/com/lolzteam/market/MarketApi.java — Market API methods (115 endpoints)

Regenerate:

# Build code generator
mvn -pl codegen clean package -DskipTests

# Run generation
java -jar codegen/target/lolzteam-codegen-*-jar-with-dependencies.jar \
    schemas/forum.json schemas/market.json \
    lolzteam-api/src/main/java/com/lolzteam

Request Bodies

The Java client automatically forms request bodies:

  • JSON — for most POST/PUT/PATCH requests (Jackson ObjectNode)
  • Multipart — for file uploads (avatar, background)

Avatar upload example:

import com.lolzteam.LolzteamClient;
import com.fasterxml.jackson.databind.JsonNode;

LolzteamClient client = LolzteamClient.create("YOUR_TOKEN");

// Upload avatar from file
JsonNode result = client.forum().usersAvatarUpload(
    1L,               // userId
    "avatar.png",     // file path
    0L,               // x
    0L,               // y
    256L              // crop
);

Endpoint Parameters

Endpoints with more than three optional parameters accept Map<String, Object>:

import java.util.Map;
import java.util.HashMap;

// Search Steam accounts with filters
Map<String, Object> params = new HashMap<>();
params.put("pmin", 10);
params.put("pmax", 100);
params.put("page", 1);

JsonNode results = client.market().categorySteam(params);

Forum API

Categories

Method Description
categoriesGet(categoryId) Get category
categoriesList(parentCategoryId, parentForumId, order) List categories

Forums

Method Description
forumsGet(forumId) Get forum
forumsList(parentCategoryId, parentForumId, order) List forums
forumsGrouped() Forums grouped by category
forumsFollow(forumId, params) Follow a forum
forumsUnfollow(forumId) Unfollow a forum
forumsFollowed(total) List followed forums
forumsFollowers(forumId) Forum followers
forumsGetFeedOptions() Get feed options
forumsEditFeedOptions(nodeIds, keywords) Edit feed options

Threads

Method Description
threadsList(params) List threads
threadsGet(threadId, fieldsInclude) Get thread
threadsCreate(postBody, forumId, params) Create thread
threadsEdit(threadId, params) Edit thread
threadsDelete(threadId, reason) Delete thread
threadsMove(threadId, nodeId, params) Move thread
threadsBump(threadId) Bump thread
threadsRecent(params) Recent threads
threadsUnread(limit, forumId, dataLimit) Unread threads
threadsCreateContest(postBody, contestType, ...) Create contest
threadsClaim(asResponder, ...) Create claim
threadsFollow(threadId, email) Follow thread
threadsUnfollow(threadId) Unfollow thread
threadsFollowed(total, fieldsInclude) Followed threads
threadsFollowers(threadId) Thread followers
threadsPollGet(threadId) Get poll
threadsPollVote(threadId, responseId, responseIds) Vote in poll
threadsStar(threadId) Star thread
threadsUnstar(threadId) Unstar thread
threadsHide(threadId) Hide thread
threadsFinish(threadId) Finish thread
threadsNavigation(threadId) Thread navigation

Posts

Method Description
postsList(params) List posts
postsGet(postId) Get post
postsCreate(postBody, threadId, quotePostId) Create post
postsEdit(postId, postBody) Edit post
postsDelete(postId, reason) Delete post
postsLike(postId) Like post
postsUnlike(postId) Unlike post
postsLikes(postId, page, limit) List likes
postsReport(postId, message) Report post
postsReportReasons(postId) Report reasons
postsCommentsCreate(postId, commentBody) Create comment
postsCommentsGet(postId, before, beforeComment) Get comment
postsCommentsEdit(postCommentId, commentBody) Edit comment
postsCommentsDelete(postCommentId, reason) Delete comment

Profile Posts

Method Description
profilePostsList(userId, params) List profile posts
profilePostsGet(profilePostId) Get profile post
profilePostsCreate(userId, postBody) Create profile post
profilePostsEdit(profilePostId, postBody, disableComments) Edit profile post
profilePostsDelete(profilePostId, reason) Delete profile post
profilePostsLike(profilePostId) Like
profilePostsUnlike(profilePostId) Unlike
profilePostsStick(profilePostId) Pin
profilePostsUnstick(profilePostId) Unpin
profilePostsCommentsList(profilePostId, before, limit) List comments
profilePostsCommentsCreate(profilePostId, commentBody) Create comment
profilePostsCommentsEdit(commentId, commentBody) Edit comment
profilePostsCommentsDelete(commentId) Delete comment

Users

Method Description
usersGet(userId, fieldsInclude) Get user
usersFind(username, customFields, fieldsInclude) Find user
usersList(page, limit, fieldsInclude) List users
usersEdit(userId, params) Edit profile
usersFollow(userId) Follow
usersUnfollow(userId) Unfollow
usersFollowers(userId, order, page, limit) Followers
usersFollowings(userId, order, page, limit) Followings
usersIgnore(userId) Ignore
usersUnignore(userId) Unignore
usersIgnored(total) Ignored list
usersLikes(userId, params) User likes
usersTrophies(userId) Trophies
usersContents(userId, page, limit) User content
usersClaims(userId, type, claimState) User claims
usersFields() Profile fields
usersAvatarUpload(userId, avatar, x, y, crop) Upload avatar
usersAvatarDelete(userId) Delete avatar
usersAvatarCrop(userId, x, y, crop) Crop avatar
usersBackgroundUpload(userId, background, x, y, crop) Upload background
usersBackgroundDelete(userId) Delete background
usersBackgroundCrop(userId, x, y, crop) Crop background

Conversations

Method Description
conversationsList(folder, page, limit) List conversations
conversationsGet(conversationId) Get conversation
conversationsCreate(params) Create conversation
conversationsUpdate(conversationId, params) Update conversation
conversationsDelete(conversationId, deleteType) Delete conversation
conversationsRead(conversationId) Mark as read
conversationsReadAll() Mark all as read
conversationsMessagesList(conversationId, params) List messages
conversationsMessagesGet(messageId) Get message
conversationsMessagesCreate(conversationId, messageBody, replyMessageId) Send message
conversationsMessagesEdit(conversationId, messageId, messageBody) Edit message
conversationsMessagesDelete(conversationId, messageId) Delete message
conversationsSearch(q, conversationId, searchRecipients) Search conversations
conversationsStar(conversationId) Star
conversationsUnstar(conversationId) Unstar
conversationsInvite(conversationId, recipients) Invite
conversationsKick(conversationId, userId) Kick

Search

Method Description
searchAll(params) Search everything
searchThreads(params) Search threads
searchPosts(params) Search posts
searchProfilePosts(params) Search profile posts
searchTagged(params) Search by tags
searchUsers(q) Search users
searchResults(searchId, page, limit) Search results

Notifications

Method Description
notificationsList(type, page, limit) List notifications
notificationsGet(notificationId) Get notification
notificationsRead(notificationId) Mark as read

Tags

Method Description
tagsPopular() Popular tags
tagsList(page, limit) List tags
tagsGet(tagId, page, limit) Get tag
tagsFind(tag) Find tag

Chatbox

Method Description
chatboxIndex(roomId) Chatbox index
chatboxGetMessages(roomId, beforeMessageId) Get messages
chatboxPostMessage(roomId, message, replyMessageId) Post message
chatboxEditMessage(messageId, message) Edit message
chatboxDeleteMessage(messageId) Delete message
chatboxOnline(roomId) Online users
chatboxGetLeaderboard(duration) Leaderboard
chatboxReport(messageId, reason) Report
chatboxReportReasons(messageId) Report reasons
chatboxGetIgnore() Ignore list
chatboxPostIgnore(userId) Add to ignore
chatboxDeleteIgnore(userId) Remove from ignore

Other

Method Description
navigationList(parent) Navigation
oAuthToken(grantType, clientId, clientSecret, params) Get access token
batchExecute() Batch request
assetsCss(css) Get CSS
formsList(page) List forms
formsCreate(formId, fields) Create form
pagesList(parentPageId, order) List pages
pagesGet(pageId) Get page
linksList() List links
linksGet(linkId) Get link

Market API

Categories

Method Description
categoryList(topQueries) List categories
categoryParams(categoryName) Category parameters
categoryGames(categoryName) Category games

Category Search

Method Description
categoryAll(params) Search all categories
categorySteam(params) Steam accounts
categoryFortnite(params) Fortnite accounts
categoryDiscord(params) Discord accounts
categoryTelegram(params) Telegram accounts
categoryMinecraft(params) Minecraft accounts
categoryRoblox(params) Roblox accounts
categoryRiot(params) Riot Games accounts
categoryEpicGames(params) Epic Games accounts
categoryEA(params) EA accounts
categoryBattleNet(params) Battle.net accounts
categoryUplay(params) Uplay accounts
categorySocialClub(params) Social Club accounts
categoryWot(params) World of Tanks accounts
categoryWotBlitz(params) WoT Blitz accounts
categoryWarface(params) Warface accounts
categorySupercell(params) Supercell accounts
categoryMihoyo(params) miHoYo accounts
categoryEscapeFromTarkov(params) Escape from Tarkov accounts
categoryInstagram(params) Instagram accounts
categoryTikTok(params) TikTok accounts
categoryChatGPT(params) ChatGPT accounts
categoryVpn(params) VPN accounts
categoryGifts(params) Gift cards
categoryHytale(params) Hytale accounts

Account Lists

Method Description
listUser(params) My accounts
listFavorites(params) Favorites
listOrders(params) Orders
listViewed(params) Viewed
listStates(userId) Account states
listDownload(type, params) Download list

Account Managing

Method Description
managingGet(itemId, parseSameItemIds) Get account
managingEdit(itemId, params) Edit account
mangingDelete(itemId, reason) Delete account
managingBump(itemId) Bump account
managingAutoBump(itemId, hour) Auto-bump
managingAutoBumpDisable(itemId) Disable auto-bump
managingAutoBuyPrice(itemId) Auto-buy price
managingStick(itemId) Stick
managingUnstick(itemId) Unstick
managingFavorite(itemId) Add to favorites
managingUnfavorite(itemId) Remove from favorites
managingTag(itemId, tagId) Add tag
managingUntag(itemId, tagId) Remove tag
managingPublicTag(itemId, tagId) Public tag
managingPublicUntag(itemId, tagId) Remove public tag
managingNote(itemId, text) Note
managingImage(itemId, type) Image
managingClose(itemId) Close
managingOpen(itemId) Open
managingTransfer(itemId, username, secretAnswer) Transfer account
managingChangePassword(itemId, cancel) Change password
managingAIPrice(itemId) AI price estimate
managingBulkGet(itemId, parseSameItemIds) Bulk get
managingCreateClaim(itemId, postBody) Create claim
managingCheckGuarantee(itemId) Check guarantee
managingRefuseGuarantee(itemId) Refuse guarantee
managingEmailCode(itemId) Email code
managingTelegramCode(itemId) Telegram code
managingTelegramResetAuth(itemId) Telegram auth reset
managingTempEmailPassword(itemId) Temp email password
managingSteamValue(link, appId, currency, ignoreCache) Steam value
managingSteamUpdateValue(itemId, all, appId, authorize) Update Steam value
managingSteamInventoryValue(itemId, appId, currency, ignoreCache) Inventory value
managingSteamPreview(itemId, type) Steam preview
managingSteamMafileCode(itemId) maFile code
managingSteamGetMafile(itemId) Get maFile
managingSteamAddMafile(itemId) Add maFile
managingSteamRemoveMafile(itemId) Remove maFile
managingSteamSDA(itemId, id, nonce) Steam Desktop Auth

Account Publishing

Method Description
publishingAdd(price, categoryId, currency, itemOrigin, params) Add account
publishingCheck(itemId, params) Check account
publishingFastSell(price, categoryId, currency, itemOrigin, params) Fast sell
publishingExternal(itemId, type, login, emailLoginData, cookies) External account

Account Purchasing

Method Description
purchasingFastBuy(itemId, price, balanceId) Fast buy
purchasingConfirm(itemId, price, balanceId) Confirm purchase
purchasingCheck(itemId) Check purchase
purchasingDiscountRequest(itemId, discountPrice, message) Request discount
purchasingDiscountCancel(itemId) Cancel discount request

Cart

Method Description
cartGet(params) Get cart
cartAdd(itemId) Add to cart
cartDelete(itemId) Remove from cart

Payments

Method Description
paymentsHistory(params) Payment history
paymentsCurrency() Currency rates
paymentsFee(amount) Fee
paymentsTransfer(amount, currency, params) Transfer
paymentsPayout(paymentSystem, wallet, amount, currency, includeFee, extra) Payout
paymentsPayoutServices() Payout services
paymentsCancel(paymentId) Cancel payment
paymentsBalanceList() Balance list
paymentsBalanceExchange(fromBalance, toBalance, amount) Currency exchange

Invoices

Method Description
paymentsInvoiceCreate(currency, amount, paymentId, ...) Create invoice
paymentsInvoiceGet(invoiceId, paymentId) Get invoice
paymentsInvoiceList(params) List invoices

Auto Payments

Method Description
autoPaymentsCreate(usernameReceiver, day, amount, ...) Create auto-payment
autoPaymentsDelete(autoPaymentId) Delete auto-payment
autoPaymentsList() List auto-payments

Custom Discounts

Method Description
customDiscountsCreate(userId, categoryId, discountPercent, ...) Create discount
customDiscountsDelete(discountId) Delete discount
customDiscountsEdit(discountId, discountPercent, minPrice, maxPrice) Edit discount
customDiscountsGet() List discounts

Profile

Method Description
profileGet(fieldsInclude) Get profile
profileEdit(params) Edit profile
profileClaims(type, claimState) Claims

Proxy

Method Description
proxyGet() Get proxy
proxyAdd(params) Add proxy
proxyDelete(proxyId, deleteAll) Delete proxy

IMAP

Method Description
imapCreate(domain, imapServer, port, secure) Add IMAP
imapDelete(domain) Delete IMAP

Other

Method Description
batch() Batch request