LevelUp Directory

Documentation de l’API

Les propriétaires envoient taux et stock. Les lectures publiques ne renvoient jamais de clés ni de notes privées.

Authentification

Chaque bot a sa clé. Envoyez Authorization: Bearer. Ne mettez jamais la clé dans l’URL.

Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/json

Comment obtenir une clé

  1. Se connecter avec SteamUtilisez le compte Steam qui est le bot, ou le vôtre si vous êtes le propriétaire.
  2. Enregistrer le botSur le compte du bot, activez l’interrupteur et indiquez le SteamID64 du propriétaire.
  3. Confirmer la propriétéConnectez-vous comme propriétaire et confirmez. Avant cela, personne ne gère le bot.
  4. Générer une clé d’APIOuvrez le bot et générez une clé. Elle s’affiche une fois et n’est gardée que comme hash.
  5. Synchroniser les donnéesEnvoyez taux et stock à l’endpoint de la catégorie. Une mise à jour récente rend le point vert.

Unités

POST /api/v1/bots/levelup/update

Les taux TF2 sont des sets pour 1 clé. Les taux gems sont des gems pour 1 set. maxStock est distinct du stock actuel.

{
  "selling": { "tf2": 20, "gem": 12000 },
  "buying": { "tf2": 22, "gem": 13000 },
  "sets": { "730": 10, "570": 5 },
  "stockSets": 1500,
  "maxStock": 3000,
  "maxLevel": 250
}

POST /api/v1/bots/gems/update

Les taux gems sont des gems pour 1 clé TF2. La vente est ce que le bot donne. L’achat est ce que le bot demande.

{
  "selling": { "tf2": 6500 },
  "buying": { "tf2": 6800 },
  "gemStock": 1000000,
  "tf2Stock": 150
}

POST /api/v1/bots/crypto/update

Indiquez rateUnit et amountCurrency. Le répertoire ne suppose pas un seul modèle pour tous les crypto bots.

{
  "rateUnit": "USD per 1 key",
  "amountCurrency": "USD",
  "currencies": [
    { "symbol": "BTC", "network": "Bitcoin", "enabled": true },
    { "symbol": "USDT", "network": "TRC20", "enabled": true }
  ],
  "services": ["buy", "sell"],
  "rates": { "buy": 0.98, "sell": 1.02 },
  "fees": { "buyPercent": 2, "sellPercent": 2 },
  "minAmount": 5,
  "maxAmount": 500,
  "available": true
}

POST /api/v1/bots/misc/update

Envoyez un type, une liste de services et des champs facultatifs.

{
  "type": "trading",
  "services": ["buy", "sell"],
  "fields": [{ "key": "fee", "label": "Fee", "value": "2%" }]
}

Lectures publiques

Les listes publiques acceptent q, sort, dir, page, per_page et synced. Les bots privés sont absents.

Exemple fetch

await fetch('https://dev.lvlupbot.com/api/v1/bots/levelup/update', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.DIRECTORY_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ stockSets: 1500, maxStock: 3000, maxLevel: 250 })
});

Exemple axios

import axios from 'axios';

await axios.post('https://dev.lvlupbot.com/api/v1/bots/gems/update', {
  selling: { tf2: 6500 },
  buying: { tf2: 6800 },
  gemStock: 1000000,
  tf2Stock: 150
}, {
  headers: { Authorization: `Bearer ${process.env.DIRECTORY_KEY}` }
});

Succès

{
  "ok": true,
  "steamid": "7656119...",
  "category": "levelup",
  "synced_at": "2026-11-20T13:00:00+00:00",
  "sync": "synced"
}

Erreurs

Limites

Chaque clé peut envoyer 60 requêtes par minute. Un administrateur peut changer la limite.

Sécurité

OpenAPI JSON · OpenAPI YAML