API publique Craftaria

SlimeApi

Index Modules OpenAPI

Documentation API Craftaria

Routes JSON publiques, exemples prêts à tester, limites utiles et champs importants pour intégrer les données Craftaria.

Vue d'ensemble

Toutes les routes publiques 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 cache

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.
snapshotLes modules lourds sont servis depuis un cache mémoire pour protéger le serveur.

Hôtel des ventes

Annonces en direct, agrégations de prix et statistiques publiques de l'HDV.

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. 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

Champs utiles

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 moyen 7 jours par item. Paramètres : q, offset, limit. GET/api/v1/module/shop/prices/{itemKey}Prix moyen 7 jours d'un item. GET/api/v1/module/shop/statsStatistiques des shops.

Exemples

Rechercher un item

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

Prix moyen 7 jours

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

materialType Bukkit de l'item.
pricePrix public du shop.
itemKey, average7dPrix moyen 7 jours exposé par item.
remainingStockStock restant détecté.
world, x, y, zPosition publique du shop.

Classements

Boards publiques, positions, scores bruts et scores formatés.

GET/api/v1/module/leaderboardIndex du module classements. GET/api/v1/module/leaderboard/boardsListe des boards. Paramètres : q, offset, limit. GET/api/v1/module/leaderboard/boards/{id}Détail public d'une board. 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, weeklyDisponibles si le snapshot les expose.
monthly, yearlyDisponibles selon la configuration serveur.
limitLa réponse publique est bornée par la configuration de SlimeAPI.

Seen

Présence publique d'un joueur : en ligne, serveur courant si connu, première et dernière activité.

GET/api/v1/module/seenIndex du module seen. GET/api/v1/module/seen/players/{name}Présence publique par pseudo. GET/api/v1/module/seen/players?name={name}Format query équivalent.

Champs utiles

onlineStatut de connexion public.
onlineServerServeur courant si disponible.
firstSeenAtPremière connexion connue.
lastSeenAtDernière activité connue.

ServerInfo

Lecture live des valeurs serveur publiques autorisées.

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

slimehouses/house_enchanteur_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_enchanteur_share_value
slimehouses/house_enchanteur_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_enchanteur_budget
slimehouses/house_enchanteur_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_enchanteur_dividend_per_participation
slimehouses/house_bucheron_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_bucheron_share_value
slimehouses/house_bucheron_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_bucheron_budget
slimehouses/house_bucheron_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_bucheron_dividend_per_participation
slimehouses/house_armurier_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_armurier_share_value
slimehouses/house_armurier_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_armurier_budget
slimehouses/house_armurier_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_armurier_dividend_per_participation
slimehouses/house_chasseur_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_chasseur_share_value
slimehouses/house_chasseur_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_chasseur_budget
slimehouses/house_chasseur_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_chasseur_dividend_per_participation
slimehouses/house_fermier_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_fermier_share_value
slimehouses/house_fermier_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_fermier_budget
slimehouses/house_fermier_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_fermier_dividend_per_participation
slimehouses/house_mineur_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_mineur_share_value
slimehouses/house_mineur_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_mineur_budget
slimehouses/house_mineur_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_mineur_dividend_per_participation
slimehouses/house_pecheur_share_valueGET /api/v1/module/serverinfo/values?path=slimehouses/house_pecheur_share_value
slimehouses/house_pecheur_budgetGET /api/v1/module/serverinfo/values?path=slimehouses/house_pecheur_budget
slimehouses/house_pecheur_dividend_per_participationGET /api/v1/module/serverinfo/values?path=slimehouses/house_pecheur_dividend_per_participation

PlayerInfo

Lecture live des valeurs joueur publiques autorisées.

GET/api/v1/module/playerinfoIndex du module PlayerInfo. GET/api/v1/module/playerinfo/players/{name}Lit une valeur publique d'un joueur. Paramètre : key.

Exemples

Valeur joueur

GET /api/v1/module/playerinfo/players/BlacKtoeZ?key=exemple.key.publique

Autre joueur

GET /api/v1/module/playerinfo/players/JoueurExemple?key=exemple.key.publique

Valeurs disponibles

recommandationGET /api/v1/module/playerinfo/players/BlacKtoeZ?key=recommandation