API Publique — Aucune clé requise

Documentation API OneHeberge

Intégrez notre catalogue de services et nos tarifs directement dans votre application ou ERP.

BASE URL https://oneheberge.fr/api/v1
Accès libre — Les endpoints du catalogue sont publics et ne nécessitent aucune authentification. Limite : 60 requêtes / minute par IP.
Catalogue de services
GET /api/v1/products Lister tous les produits actifs
ParamètreTypeDescription
category optionnelstringFiltrer par catégorie (ex: minecraft, fivem, vps-amd)
search optionnelstringRecherche dans le nom du produit
Exemple de requête
GET https://oneheberge.fr/api/v1/products?category=minecraft
Exemple de réponse
{
  "success": true,
  "data": {
    "products": [
      {
        "id": 1,
        "name": "Minecraft Basic",
        "slug": "minecraft-basic",
        "category": "minecraft",
        "status": "active",
        "specs": { "ram": "2 GB", "cpu": "2 vCPU", "disk": "30 GB" },
        "pricing": {
          "base_price": 2.99,
          "currency": "EUR",
          "cycles": {
            "monthly":       { "months": 1,  "discount_pct": 0,  "price_month": 2.99,  "price_total": 2.99  },
            "quarterly":     { "months": 3,  "discount_pct": 5,  "price_month": 2.84,  "price_total": 8.52  },
            "semi_annually": { "months": 6,  "discount_pct": 10, "price_month": 2.69,  "price_total": 16.15 },
            "annually":      { "months": 12, "discount_pct": 15, "price_month": 2.54,  "price_total": 30.50 }
          }
        }
      }
    ],
    "total": 11
  },
  "timestamp": 1782000000
}
GET /api/v1/products/{id} Détail d'un produit
Exemple
GET https://oneheberge.fr/api/v1/products/1
GET /api/v1/products/categories Liste des catégories disponibles
minecraft 11 produits
fivem 4 produits
rust 4 produits
vps-intel 3 produits
vps-amd 3 produits
vps-windows 6 produits
cloud 4 produits
dedicated 21 produits
bot-discord 5 produits
web 3 produits
gaming 28 produits
fs25 4 produits
novalife 3 produits
domain 3 produits
fibre 3 produits
Calcul de budget
POST /api/v1/products/calculate Calculer le coût d'un panier de produits

Envoyez une liste de produits avec leurs quantités et cycles de facturation pour obtenir une estimation de coût détaillée.

ChampTypeDescription
items requisarrayListe de produits à calculer (max 50)
items[].product_id requisintegerID du produit (voir GET /products)
items[].quantity optionnelintegerQuantité (défaut : 1)
items[].billing_cycle optionnelstringmonthly | quarterly | semi_annually | annually (défaut : monthly)
Exemple de requête
POST https://oneheberge.fr/api/v1/products/calculate
Content-Type: application/json

{
  "items": [
    { "product_id": 1,  "quantity": 1, "billing_cycle": "monthly"  },
    { "product_id": 7,  "quantity": 2, "billing_cycle": "annually" }
  ]
}
Exemple de réponse
{
  "success": true,
  "data": {
    "lines": [
      {
        "product_id": 1,
        "product_name": "Minecraft Basic",
        "quantity": 1,
        "billing_cycle": "monthly",
        "unit_price_monthly": 2.99,
        "discount_pct": 0,
        "setup_fee": 0,
        "line_total_period": 2.99
      }
    ],
    "total_monthly_est": 8.07,
    "total_period": 63.99,
    "currency": "EUR",
    "note": "total_monthly_est est une estimation mensuelle. total_period est le montant réel à payer."
  }
}
Format des réponses
// Succès
{ "success": true, "message": "Success", "data": { /* ... */ }, "timestamp": 1782000000 }

// Erreur
{ "success": false, "error": "Message d'erreur", "code": 404 }
Codes HTTP
CodeSignification
200Succès
400Paramètre manquant ou invalide
404Produit introuvable
429Limite de requêtes atteinte (60 req/min)
500Erreur serveur
Des questions sur l'intégration ? Ouvrez un ticket sur notre Discord ou contactez-nous via le formulaire de contact.