API publique du réseau

Construisez avec VikingCraft

Explorez les routes, consultez leurs données et connectez vos projets à la vie du serveur.

Essayer une requête Spécification OpenAPI ↗

JSON natifLecture seule · GETRoutes publiques sans token

Documentation des routes

Cliquez sur une route pour ouvrir le JSON, ou sur « Essayer » pour utiliser la console. Renseignez d’abord les paramètres entre accolades.

Vue d'ensemble

Les routes des modules sont sous /api/v1/module. Les réponses réussies utilisent généralement apiVersion, generatedAt et data.

Index API Modules actifs OpenAPI public

GET/api/v1Index public GET/api/v1/modulesModules actifs JSON/api/v1/openapi.jsonSpec publique

Pagination et actualisation

limitNombre de résultats à retourner. Les limites exactes dépendent du module.

offsetDécalage pour paginer sans changer le format des réponses.

qRecherche texte quand le module le supporte.

ActualisationLes annonces, shops et classements sont actualisés périodiquement. Consultez leur date de mise à jour.

Hôtel des ventes

Annonces, ventes confirmées des 30 dernières minutes et prix par variante d'objet. Les données sont actualisées périodiquement.

GET/api/v1/module/hdvIndex du module HDV. GET/api/v1/module/hdv/itemsListe des annonces. Paramètres : q, seller, category, sort, offset, limit. GET/api/v1/module/hdv/items/{id}Détail public d'une annonce ou d'une vente récente, avec son statut. GET/api/v1/module/hdv/salesVentes confirmées sur 30 minutes, plus récentes en premier. Paramètres : q, seller, offset, limit. GET/api/v1/module/hdv/marketPrix agrégés par item. GET/api/v1/module/hdv/market/{key}Prix agrégés d'un item précis. GET/api/v1/module/hdv/statsStatistiques globales du module.

Exemples

Annonces les moins chères

GET /api/v1/module/hdv/items?q=diamond&sort=price_asc&limit=25

Prix fiables

GET /api/v1/module/hdv/market?q=netherite&sort=reliable

Statistiques

GET /api/v1/module/hdv/stats

Ventes récentes

GET /api/v1/module/hdv/sales?q=collection&limit=25

Champs utiles

loreDescription de l'objet custom, en lignes de texte sans mise en forme.

itemKeyEmpreinte de la variante d'objet, utilisée pour regrouper les prix. Ce n'est pas un identifiant officiel de collection.

status / soldAtLISTED pour une annonce active ; SOLD et date de vente pour un achat confirmé.

medianUnitPricePrix médian par unité.

trustedAverageUnitPriceMoyenne filtrée contre les valeurs extrêmes.

reliableIndique si assez de sources existent pour un prix stable.

sampleListingIdsExemples d'annonces utilisées pour le calcul.

Shops joueurs

Shops publics, type d'échange, prix, stock restant, monde et position.

GET/api/v1/module/shopIndex du module shops. GET/api/v1/module/shop/shopsListe des shops. Paramètres : q, owner, world, type, offset, limit. GET/api/v1/module/shop/shops/{id}Détail public d'un shop. GET/api/v1/module/shop/pricesPrix et volumes sur 24 h et 7 jours. Paramètres : q, offset, limit. GET/api/v1/module/shop/prices/{itemKey}Statistiques de prix et volumes pour un item. GET/api/v1/module/shop/statsStatistiques des shops.

Exemples

Rechercher un item

GET /api/v1/module/shop/shops?q=diamond

Filtrer un propriétaire

GET /api/v1/module/shop/shops?owner=BlacKtoeZ

Prix et volumes des diamants

GET /api/v1/module/shop/prices?q=diamond

Filtrer un monde

GET /api/v1/module/shop/shops?world=world&limit=50

Statistiques

GET /api/v1/module/shop/stats

Champs utiles

nameNom personnalisé de l'item ou nom français standard, sans mise en forme. Vaut null si le nom est indisponible.

materialMatériau Minecraft de l'item, distinct de son nom.

ownerNamePseudo connu du propriétaire, ou null si inconnu. Le filtre owner accepte un pseudo partiel, sans distinction de casse.

pricePrix public du shop.

itemKeyIdentifiant de l'item, utilisé pour consulter ses statistiques de shops.

remainingStockStock restant détecté.

world, x, y, zPosition publique du shop.

Prix et volumes des shops

Les routes /prices présentent les prix et volumes des transactions des shops sur 24 h et 7 jours, séparément des annonces de l'hôtel des ventes.

availableHistorique disponible avec au moins une transaction sur 7 jours. Sans historique, les prix historiques valent null.

sales24h, sales7dNombre de transactions sur 24 h et 7 jours, achats et ventes des shops confondus.

volume24h, volume7dQuantité d'objets échangés sur chaque période.

average24h, average7dPrix unitaires moyens pondérés par les quantités. La moyenne 24 h vaut null sans transaction sur cette période.

median7dMédiane des prix unitaires par transaction sur 7 jours.

lastSalePriceDernier prix unitaire connu.

currentLowestPrice, currentHighestPricePrix minimum et maximum des offres BUY et SELL connues. Vaut 0 sans offre connue.

Statistiques indisponiblesavailable vaut false et les statistiques valent null. Les shops restent consultables.

Classements

Classements publics, positions, scores bruts et scores formatés.

GET/api/v1/module/leaderboardIndex du module classements. GET/api/v1/module/leaderboard/boardsListe des classements. Paramètres : q, offset, limit. GET/api/v1/module/leaderboard/boards/{id}Détail public d'un classement. GET/api/v1/module/leaderboard/boards/{id}/entriesTop joueurs. Paramètres : period, offset, limit. GET/api/v1/module/leaderboard/statsStatistiques des classements.

Exemples

Lister les boards

GET /api/v1/module/leaderboard/boards

Top alltime

GET /api/v1/module/leaderboard/boards/level/entries?period=alltime&limit=100

Pagination

GET /api/v1/module/leaderboard/boards/prestige/entries?period=alltime&offset=50&limit=50

Périodes

alltimeClassement global.

hourly, daily, weeklyPar heure, jour ou semaine, si disponibles.

monthly, yearlyPar mois ou année, si disponibles.

limitNombre de joueurs à retourner par page, dans la limite autorisée.

ServerInfo

Informations publiques du serveur, consultées à la demande.

GET/api/v1/module/serverinfoIndex du module ServerInfo. GET/api/v1/module/serverinfo/valuesLit une valeur serveur. Paramètres : path ou key.

Exemples

Valeur serveur

GET /api/v1/module/serverinfo/values?path=ServeurAccounts/player_count

Format alternatif

GET /api/v1/module/serverinfo/values?key=ServeurAccounts/player_count

Valeurs disponibles

AucuneAucune valeur publique disponible.

PlayerInfo

Sans key, consultez le profil public complet : présence, niveau, argent, temps de jeu et autres informations publiques disponibles. Utilisez une key pour consulter un seul champ.

GET/api/v1/module/playerinfoIndex du module PlayerInfo. GET/api/v1/module/playerinfo/players/{name}Profil public : pseudo, présence, niveau, argent et temps de jeu. GET/api/v1/module/playerinfo/players/{name}?key=seenPrésence et dates de connexion uniquement. GET/api/v1/module/playerinfo/players/{name}?key=serverlevelNiveau du serveur uniquement. GET/api/v1/module/playerinfo/players/{name}?key=moneyArgent du joueur en dollars ($). GET/api/v1/module/playerinfo/players/{name}?key=playtimeTemps de jeu enregistré et durée de la session en cours. GET/api/v1/module/playerinfo/players/{name}?key=recommandationRecommandations du joueur.

Exemples

Profil public complet

GET /api/v1/module/playerinfo/players/{name}

Présence uniquement

GET /api/v1/module/playerinfo/players/{name}?key=seen

Niveau du serveur uniquement

GET /api/v1/module/playerinfo/players/{name}?key=serverlevel

Argent uniquement

GET /api/v1/module/playerinfo/players/{name}?key=money

Temps de jeu uniquement

GET /api/v1/module/playerinfo/players/{name}?key=playtime

recommandation

GET /api/v1/module/playerinfo/players/{name}?key=recommandation

Champs du profil

playerPseudo canonique du joueur.

seenPrésence et historique : online, onlineServer, firstSeenAt, lastSeenAt et dates de session connues. Les dates inconnues restent null.

serverlevelNiveau du serveur sous forme d'entier, par exemple 500. Distinct du niveau d'expérience Minecraft. Null si indisponible.

moneySolde du joueur en dollars ($), au centime. Null si le compte ou l'économie est indisponible.

playtimerecordedSeconds : cumul enregistré à la fin des sessions. sessionSeconds : session actuelle, 0 hors ligne. Les deux durées sont séparées et ne s'additionnent pas automatiquement.

recommandationRecommandations du joueur. Chaîne de caractères, ou null si indisponible.

Explorez une réponse

Choisissez une route publique, puis exécutez la requête.

Sur ce serveur

La disponibilité dépend des modules du serveur.

La réponse s’affichera ici.Choisissez une route puis cliquez sur Exécuter.

Prêt— · —

Choisissez une route puis cliquez sur Exécuter.