API publique VikingCraft

Modules disponibles

Chaque module a son propre chemin sous `/api/v1/module/{nom}`.

GET /api/v1

Index general de l'API.

GET /api/v1/modules

Liste des modules publics et de leur etat.

GET /api/v1/openapi.json

Specification pour brancher des outils externes.

API hotel des ventes

Annonces en direct, prix par item, vendeurs, quantites, categories et statistiques de l'hotel des ventes.

GET /api/v1/module/hdv

Resume des endpoints de l'hotel des ventes.

GET /api/v1/module/hdv/items

Annonces live. Filtres: `q`, `seller`, `category`, `sort`, `offset`, `limit`.

GET /api/v1/module/hdv/items/{id}

Detail public d'une annonce.

GET /api/v1/module/hdv/market

Prix par item: min, max, moyenne, mediane, moyenne fiable.

GET /api/v1/module/hdv/stats

Statistiques globales de l'hotel des ventes.

Exemples HDV

Prix fiables d'un item

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

Annonces les moins cheres

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

Stats HDV

GET /api/v1/module/hdv/stats

Champs importants

medianUnitPricePrix median par unite, plus stable qu'une moyenne brute.

trustedAverageUnitPriceMoyenne apres filtre anti-outliers simple.

reliable`true` quand il y a au moins 5 annonces pour l'item.

sampleListingIdsQuelques annonces sources pour inspecter les donnees.

API classements

Classements publics du serveur avec joueurs, positions, scores et periodes.

GET /api/v1/module/leaderboard

Resume des endpoints de classements.

GET /api/v1/module/leaderboard/boards

Liste des classements. Filtres: `q`, `offset`, `limit`.

GET /api/v1/module/leaderboard/boards/{id}

Detail public d'un classement.

GET /api/v1/module/leaderboard/boards/{id}/entries

Top joueurs. Filtres: `period`, `offset`, `limit`.

GET /api/v1/module/leaderboard/stats

Statistiques globales des classements.

Exemples classements

Lister les classements

GET /api/v1/module/leaderboard/boards

Top level

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

Top prestige

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

Top skill

GET /api/v1/module/leaderboard/boards/skill_donjon/entries?period=weekly&limit=25

Champs importants

positionRang du joueur dans le classement.

playerNameNom public du joueur.

scoreValeur brute pour faire des graphiques.

formattedScoreScore deja formate pour l'affichage.

API joueurs vus

Informations publiques de presence d'un joueur: statut, premiere connexion, derniere connexion et derniere activite connue.

GET /api/v1/module/seen

Resume des endpoints joueurs vus.

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

Statut public d'un joueur par pseudo.

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

Meme resultat avec un parametre de recherche.

Exemples joueurs vus

Voir un joueur

GET /api/v1/module/seen/players/BlacKtoeZ

Format query

GET /api/v1/module/seen/players?name=BlacKtoeZ

Champs importants

online`true` si le joueur est visible comme connecte.

firstSeenAtPremiere connexion connue.

lastSeenAtDerniere activite publique connue.

lastSeenSecondsAgoNombre de secondes depuis la derniere activite.

API shops joueurs

Shops joueurs, items, prix, stocks, positions et statistiques.

GET /api/v1/module/shop

Resume des endpoints des shops joueurs.

GET /api/v1/module/shop/shops

Liste des shops. Filtres: `q`, `owner`, `world`, `type`, `offset`, `limit`.

GET /api/v1/module/shop/shops/{id}

Detail public d'un shop.

GET /api/v1/module/shop/stats

Stats shops joueurs: ventes, achats, mondes, types et prix moyen.

Exemples shops joueurs

Rechercher un item

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

Filtrer par monde

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

Stats shops

GET /api/v1/module/shop/stats

Champs importants

materialType Bukkit de l'item vendu ou achete.

pricePrix public du shop.

remainingStockStock restant detecte pour le shop.

world, x, y, zPosition publique du shop.