API Catalogue

Démarrer

1. Gardez votre jeton côté serveur

   Serv3r.net vous remet un jeton personnel. Stockez-le dans une variable d'environnement de votre serveur, par exemple SERV3R_TOKEN. Ne le placez jamais dans du code exécuté par un navigateur ou une application mobile : n'importe qui pourrait le lire.

2. Appelez le catalogue

   Envoyez une requête GET en HTTPS, avec le jeton dans l'en-tête Authorization.

   TerminalCopier

   curl -s https://api.serv3r.net/v1/catalog \
     -H "Authorization: Bearer $SERV3R_TOKEN"

   Toujours https://

   Une requête en http:// est redirigée vers HTTPS, mais le jeton a déjà circulé en clair entre-temps. Si cela arrive, demandez-en un nouveau.

3. Lisez la réponse

   Vous recevez un objet JSON. La liste des serveurs est dans products. Voici un extrait d'une réponse réelle, avec un serveur épuisé et un serveur en stock :

   Réponse · 200Copier

   {
     "generated_at": "2026-09-13T08:35:46Z",
     "stale": false,
     "currency": "CAD",
     "notice": "Quantités indicatives, non réservées.",
     "products": [
       {
         "id": 157,
         "name": "Amd Ryzen 3950x",
         "description": "Cpu:Ryzen 3950x<br>Number of cores:16c/32t<br>Frequency:3,5 GHz/4,7 GHz<br>Ram:128GB (DDR4)<br>Storage:2x 2TB NVME SSD<br>Network Port Speed:1Gbps<br>Bandwidth:Unmetered<br>IP address:1<br><ul></ul>",
         "category": { "id": 53, "name": "Amd Ryzen" },
         "available": false,
         "stock": { "tracked": true, "qty": 0 },
         "billing": "Regular",
         "prices": [
           { "cycle": "monthly", "price": "159.00", "setup": "0.00" }
         ],
         "order_url": "https://client.serv3r.net/index.php?cmd=cart&action=add&id=157&cat_id=53"
       },
       {
         "id": 158,
         "name": "Amd Ryzen 5600x",
         "description": "Cpu:Ryzen 5600x<br>Number of cores:6c/12t<br>Frequency:3,7 GHz/4,6 GHz<br>Ram:32GB (DDR4)<br>Storage:2x 2TB NVME SSD<br>Network Port Speed:1Gbps<br>Bandwidth:Unmetered<br>IP address:1<br><ul></ul>",
         "category": { "id": 53, "name": "Amd Ryzen" },
         "available": true,
         "stock": { "tracked": true, "qty": 2 },
         "billing": "Regular",
         "prices": [
           { "cycle": "monthly", "price": "129.00", "setup": "0.00" }
         ],
         "order_url": "https://client.serv3r.net/index.php?cmd=cart&action=add&id=158&cat_id=53"
       }
     ]
   }

La réponse

Enveloppe

Chaque serveur

Stock et disponibilité

Pour savoir si un serveur peut être commandé, lisez available. Pour afficher une quantité, lisez stock :

• Les serveurs épuisés restent dans la liste, avec available à false.
• Les quantités sont mises à jour en continu et vous parviennent en 30 secondes au plus.
• Elles ne réservent rien : un serveur peut partir entre votre lecture et la commande de votre client.

Prix

prices contient un tarif par durée d'engagement proposée. Aujourd'hui, tous les serveurs sont proposés au mois, sans frais d'installation ; d'autres durées peuvent apparaître.

• price : montant pour une période.
• setup : frais d'installation, payés une seule fois.
• Les deux sont des textes à deux décimales avec un point, par exemple "129.00". Pour vos calculs, convertissez-les en type décimal ou en cents plutôt qu'en nombre à virgule flottante.

Valeurs possibles de cycle

Caractéristiques

description contient les caractéristiques techniques, une par ligne. Les lignes sont séparées par <br> et suivent la forme Caractéristique:Valeur. Traitez ce champ comme du texte : ne l'insérez pas tel quel dans vos pages.

const specs = product.description
  .split("<br>")
  .map((line) => line.replace(/<[^>]*>/g, "").trim())
  .filter((line) => line.includes(":"))
  .map((line) => {
    const i = line.indexOf(":");
    return [line.slice(0, i), line.slice(i + 1)];
  });

Résultat pour l'Amd Ryzen 5600x :

Lien de commande

order_url ouvre directement la page de commande du serveur dans l'espace client Serv3r.net, où votre client choisit ses options et paie.

Pour un serveur épuisé, le lien reste valide, mais la page affiche « Rupture de stock ». Masquez votre bouton de commande quand available vaut false.

Codes de réponse

Fiez-vous au code HTTP. Seules les réponses 200, 401 et 503 contiennent du JSON.

Bonnes pratiques

• Interrogez l'API depuis votre serveur. Gardez le catalogue en cache chez vous et construisez vos pages à partir de ce cache.
• Un appel toutes les 30 à 60 secondes suffit. Nos données ne se rafraîchissent pas plus vite.
• Renvoyez l'ETag. Placez la valeur de l'en-tête ETag reçu dans If-None-Match : si rien n'a changé, vous recevez un 304 sans contenu.
• Surveillez stale. S'il vaut true, les données datent de generated_at : affichez-les, sans promettre de disponibilité.
• Gardez votre dernière copie en cas d'erreur (503, coupure réseau) et réessayez plus tard.
• Tolérez les nouveaux champs. D'autres informations peuvent s'ajouter à la réponse : ne rejetez pas un objet qui en contient.

let etag = null;
let catalog = null;

async function refresh() {
  const headers = { Authorization: `Bearer ${process.env.SERV3R_TOKEN}` };
  if (etag) headers["If-None-Match"] = etag;

  try {
    const res = await fetch("https://api.serv3r.net/v1/catalog", {
      headers,
      signal: AbortSignal.timeout(10_000),
    });
    if (res.status === 200) {
      etag = res.headers.get("ETag");
      catalog = await res.json();
    }
    // 304 : rien n'a changé. Autre code : on garde la dernière copie.
  } catch {
    // Réseau indisponible : on garde la dernière copie.
  }
  return catalog;
}

await refresh();
setInterval(refresh, 60_000);

Exemples de code

Chaque exemple lit le catalogue et affiche, pour chaque serveur, son prix mensuel et son état.

<?php
$ch = curl_init('https://api.serv3r.net/v1/catalog');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('SERV3R_TOKEN')],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
]);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($body === false || $status !== 200) {
    throw new RuntimeException("Catalogue indisponible (HTTP $status)");
}

$catalog = json_decode($body, true, flags: JSON_THROW_ON_ERROR);

foreach ($catalog['products'] as $p) {
    $mensuel = array_column($p['prices'], 'price', 'cycle')['monthly'] ?? '—';
    $etat = match (true) {
        !$p['available']       => 'épuisé',
        $p['stock']['tracked'] => $p['stock']['qty'] . ' en stock',
        default                => 'disponible',
    };
    echo "{$p['name']} — {$mensuel} {$catalog['currency']}/mois — {$etat}\n";
}

const res = await fetch("https://api.serv3r.net/v1/catalog", {
  headers: { Authorization: `Bearer ${process.env.SERV3R_TOKEN}` },
  signal: AbortSignal.timeout(10_000),
});
if (!res.ok) throw new Error(`Catalogue indisponible (HTTP ${res.status})`);

const catalog = await res.json();

for (const p of catalog.products) {
  const mensuel = p.prices.find((x) => x.cycle === "monthly")?.price ?? "—";
  const etat = !p.available
    ? "épuisé"
    : p.stock.tracked ? `${p.stock.qty} en stock` : "disponible";
  console.log(`${p.name} — ${mensuel} ${catalog.currency}/mois — ${etat}`);
}

import json
import os
import urllib.request

req = urllib.request.Request(
    "https://api.serv3r.net/v1/catalog",
    headers={"Authorization": f"Bearer {os.environ['SERV3R_TOKEN']}"},
)
# urlopen lève HTTPError pour les codes 401, 429, 503…
with urllib.request.urlopen(req, timeout=10) as res:
    catalog = json.load(res)

for p in catalog["products"]:
    mensuel = next((x["price"] for x in p["prices"] if x["cycle"] == "monthly"), "—")
    if not p["available"]:
        etat = "épuisé"
    elif p["stock"]["tracked"]:
        etat = f"{p['stock']['qty']} en stock"
    else:
        etat = "disponible"
    print(f"{p['name']} — {mensuel} {catalog['currency']}/mois — {etat}")

# Réponse brute, JSON sur une seule ligne
curl -s https://api.serv3r.net/v1/catalog \
  -H "Authorization: Bearer $SERV3R_TOKEN"

# Avec les en-têtes, pour repérer ETag et Cache-Control
curl -si https://api.serv3r.net/v1/catalog \
  -H "Authorization: Bearer $SERV3R_TOKEN"

# Avec l'ETag reçu : réponse 304 si rien n'a changé
curl -si https://api.serv3r.net/v1/catalog \
  -H "Authorization: Bearer $SERV3R_TOKEN" \
  -H 'If-None-Match: "valeur-de-l-etag-recu"'

Sortie des exemples PHP, JavaScript et Python le 13 septembre 2026 :

2x Intel Xeon E5-2697 v4 — 129.00 CAD/mois — 1 en stock
Intel Xeon W-1290P — 159.00 CAD/mois — 1 en stock
Amd Ryzen 3950x — 159.00 CAD/mois — épuisé
Amd Ryzen 5600x — 129.00 CAD/mois — 2 en stock
Amd Ryzen 9950x — 259.00 CAD/mois — épuisé