Nos interfaces publiques pour revendeurs, partenaires, développeurs et agents IA : calculer les frais de port, consulter le stock, charger les données produits, préparer des paniers et exploiter les configurations du configurateur 3D. Toutes les interfaces décrites ici sont gratuites, en lecture seule et sans inscription.
ℹ️ Généralités
Format : JSON (UTF-8) ; montants sous forme de chaîne avec un point, p. ex. "18.14", en EUR (sauf indication contraire).
Authentification : aucune. Tous les points d’accès décrits ici sont publics et en lecture seule.
Erreur 403 ? Nos serveurs sont derrière Cloudflare. curl, Python requests et JavaScript fetch fonctionnent sans réglage supplémentaire ; certaines bibliothèques (p. ex. Python urllib) sont refusées. Envoyez alors votre propre User-Agent, p. ex. MeineFirma-Integration/1.0 (kontakt@example.com).
Appel depuis le navigateur (CORS) : l’API de stock et les flux produits peuvent être appelés depuis n’importe quel site. L’API des frais de port est destinée aux appels de serveur à serveur – appelez-la depuis votre backend.
Limites : frais de port pour les configurations : 60 requêtes par minute et par adresse IP (ensuite 429). Merci de ne pas interroger les données plus souvent que nécessaire et de mettre les résultats en cache (p. ex. stock 5 à 10 minutes).
Erreurs : codes HTTP (400 saisie invalide, 404 introuvable, 422 paramètres manquants ou invalides, 429 trop de requêtes). Le message figure dans le champ detail ou error.
Pour les agents IA : un aperçu compact pour les modèles de langage est disponible sous /llms.txt et /agents.md.
🚚 API frais de port
URL de base:https://modula24.com
Calcule les frais de port exactement comme notre panier et notre caisse – pour un panier, pour des poids ou pour une configuration du configurateur 3D. Les articles de notre entrepôt de Hambourg partent par DHL (colis jusqu’à 31,5 kg) ; les articles disponibles uniquement dans notre entrepôt en Chine partent par fret maritime ou aérien. Si seule une partie est à Hambourg, un envoi partiel est proposé. L’API détermine l’emplacement des articles à partir du stock actuel.
Modes d’envoi (id) : dhl (depuis Hambourg : DHL Paket International Premium, livraison à domicile ; en Allemagne colis DHL), dhl_eco (depuis Hambourg : DHL Paket International Economy, livraison en point relais/bureau de poste – uniquement hors UE et pas dans tous les pays), sea / air (articles uniquement en Chine), split_sea / split_air (envoi partiel : Hambourg par DHL Premium, le reste depuis la Chine), air_door (hors UE uniquement, si la commande contient des articles de Hambourg : toute la commande depuis l’entrepôt en Chine par avion jusqu’à la porte, dédouanée, 7 à 10 jours ouvrés), pallet (palette par transporteur depuis Hambourg, Allemagne/UE/Suisse/Norvège/Islande uniquement, jusqu’à 750 kg par palette, à partir de 100 kg, trié par prix), fourpx (4PX : toute la commande depuis l’entrepôt en Chine, avec suivi, douane prise en charge par la boutique ; aussi dans l’UE, pas dans tous les pays), sea_door (hors UE uniquement : toute la commande depuis l’entrepôt en Chine par voie maritime jusqu’à la porte, dédouanée, 9 à 11 semaines – toujours en dernier). Le tarif figure aussi dans legs[].product. Chaque option contient cost, le délai days avec unit (days = jours ouvrés, weeks = semaines) et les parties de l’envoi legs. L’option la moins chère figure en premier (sauf air_door, fourpx et sea_door, toujours en dernier).
GET/api/checkout/config
Pays de livraison – Liste des pays de livraison (codes ISO 3166) et des devises. Nous livrons uniquement ces pays.
curl https://modula24.com/api/checkout/config
const res = await fetch('https://modula24.com/api/checkout/config');
const { countries } = await res.json();
console.log(countries); // ["AT", "AU", "BE", ...]
import requests
r = requests.get("https://modula24.com/api/checkout/config", timeout=10)
print(r.json()["countries"])
Frais de port pour une configuration – Pour une configuration enregistrée du configurateur 3D : la nomenclature est convertie en articles de la boutique comme avec le bouton « Ajouter au panier ». Sans country, vous obtenez les options pour tous les pays de livraison (countries). Les pièces sans article disponible figurent dans missing – leur poids n’est pas inclus et complete vaut false. Aussi en POST avec {"config": "…"} ou une nomenclature {"bom": […]}. 60 requêtes par minute max.
Paramètres
Nom
Emplacement
Type
Description
configobligatoire
query
string
ID de configuration (p. ex. LFKDD5KLP9MG)
countryfacultatif
query
string
Pays de livraison ; vide = tous les pays
currencyfacultatif
query
string
EUR ou USD
missingfacultatif
query
integer
1 = renvoie aussi missing_shipping : frais estimés pour les pièces indisponibles depuis notre entrepôt en Chine (poids du catalogue ou estimé selon surface/longueur, +10 % d’emballage ; options fret maritime/aérien, 4PX, fourpx_split = colis de 30 kg). Valeur indicative hors droits de douane/TVA à l’importation ; ces pièces ne sont pas commandables en boutique. POST : "missing": true
curl "https://modula24.com/api/checkout/shipping?config=LFKDD5KLP9MG&country=AT"
# mit Versand-Schätzung für nicht lieferbare Teile (ab China)
curl "https://modula24.com/api/checkout/shipping?config=8JUKX9TJ2WSK&country=DE&missing=1"
const url = new URL('https://modula24.com/api/checkout/shipping');
url.searchParams.set('config', 'LFKDD5KLP9MG');
url.searchParams.set('country', 'AT');
const data = await (await fetch(url)).json();
if (!data.complete) console.warn('Nicht enthalten:', data.missing);
console.log(data.shipping_options, data.cart_url);
import requests
r = requests.get("https://modula24.com/api/checkout/shipping",
params={"config": "LFKDD5KLP9MG", "country": "AT"}, timeout=10)
d = r.json()
print(d["complete"], d["weight_kg"], d["shipping_options"], d["cart_url"])
Stock actuel de notre entrepôt de Hambourg (hamburg) par SKU. Idéal pour les revendeurs, les comparateurs de prix et les ERP. Les données sont mises à jour en continu (les ventes de tous les canaux sont comptabilisées toutes les 10 minutes) ; le champ data_updated_at indique la dernière modification. Appel possible directement depuis le navigateur (CORS).
Champs par article :sku, warehouse, title, price + currency (même prix que dans la boutique ; null si l’article n’est pas vendu en boutique), available (quantité disponible), ean, url (page produit sur modula24.com, en allemand), urls (page produit par langue : de, en, fr, it), updated_at. Si un article n’est pas proposé sur modula24.com, url et urls valent null.
GET/stock
Consulter le stock – Tous les articles ou filtrés. Les filtres sont combinables.
Paramètres
Nom
Emplacement
Type
Description
warehousefacultatif
query
string
ID de l’entrepôt (voir /warehouses), actuellement hamburg ; vide = tous
skusfacultatif
query
string
SKU séparés par des virgules, p. ex. kugel,rohr_350
const res = await fetch('https://api.modula24.com/stock?warehouse=hamburg&in_stock=true');
const { items, data_updated_at } = await res.json();
for (const i of items) console.log(i.sku, i.available);
import requests
r = requests.get("https://api.modula24.com/stock",
params={"warehouse": "hamburg", "skus": "kugel,rohr_350"}, timeout=10)
for item in r.json()["items"]:
print(item["sku"], item["available"])
Stock en CSV – Pour Excel & co. Colonnes : entrepôt, SKU, EAN, nom, prix, devise, stock, URL boutique, mise à jour.
Paramètres
Nom
Emplacement
Type
Description
warehousefacultatif
query
string
ID de l’entrepôt (voir /warehouses), actuellement hamburg ; vide = tous
in_stockfacultatif
query
boolean
uniquement les articles en stock
langfacultatif
query
string
Langue de (par défaut), en, fr, it : en-têtes, nom de l’article et URL boutique dans cette langue ; en utilise la virgule comme séparateur et le point décimal
Tous les articles commandables avec prix, disponibilité, images, poids, catégorie, couleur/taille et frais de port par pays de livraison (1 pièce, option la moins chère) – par langue en JSON et au format Google Merchant Center. Les flux sont régénérés à chaque modification de la boutique. La variant_id est nécessaire pour l’API des frais de port et le lien panier.
GET/products.json
Produits (compatible Shopify) – Tous les produits avec variantes au format Shopify habituel – les outils Shopify existants continuent de fonctionner. Produit unique : /products/{handle}.json, produits d’une catégorie : /collections/{handle}/products.json. Autres langues avec préfixe, p. ex. /fr/products.json. L’id de variante est la variant_id pour l’API des frais de port et le lien panier.
Paramètres
Nom
Emplacement
Type
Description
handlefacultatif
chemin
string
Nom d’URL du produit ou de la catégorie (issu du lien)
const { product } = await (await fetch('https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json')).json();
for (const v of product.variants) console.log(v.id, v.title, v.price, v.available);
import requests
r = requests.get("https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json", timeout=10)
for v in r.json()["product"]["variants"]:
print(v["id"], v["title"], v["price"], v["available"])
Flux Google Merchant (XML) – RSS 2.0 avec l’espace de noms Google pour Merchant Center, comparateurs de prix et places de marché. {lang} = de, en, fr, it, ja ou us (USD). Également : /sitemap.xml.
Paramètres
Nom
Emplacement
Type
Description
langobligatoire
chemin
string
Langue ou us
curl https://modula24.com/feeds/google.de.xml
const xml = await (await fetch('https://modula24.com/feeds/google.de.xml')).text();
const doc = new DOMParser().parseFromString(xml, 'application/xml');
console.log(doc.querySelectorAll('item').length);
import requests, xml.etree.ElementTree as ET
xml = requests.get("https://modula24.com/feeds/google.de.xml", timeout=20).content
G = "{http://base.google.com/ns/1.0}"
for item in ET.fromstring(xml).iter("item"):
print(item.find(G + "id").text, item.find("title").text, item.find(G + "price").text)
Réponse (abrégée)
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"><channel>
<item>
<g:id>M24-58436517069064</g:id>
<title>Konnektor Connector Verbindung - 100% kompatibel mit USM Haller</title>
<g:price>0.95 EUR</g:price>
<g:availability>in_stock</g:availability>
…
</item>
🛒 Lien panier
URL de base:https://modula24.com
Un lien qui ajoute des articles directement au panier d’un visiteur – p. ex. depuis une nomenclature, un devis, un outil de planification ou un assistant IA. Le visiteur voit « N articles ont été ajoutés au panier » et commande lui-même à la caisse. Seules les variantes connues et disponibles sont reprises ; les articles déjà présents restent, les variantes identiques sont additionnées. 60 lignes max. par lien.
LINK/cart?add={variant_id}:{qty},…
Ajouter des articles au panier – Langues : /cart (allemand), /en/cart, /fr/cart, /it/cart, /ja/cart. Avec &cfg=ID, l’ID de configuration est également affiché.
items = [("58436497375496", 8), ("58546503745800", 8)]
url = "https://modula24.com/cart?add=" + ",".join(f"{vid}:{qty}" for vid, qty in items)
print(url)
🧩 API du configurateur
URL de base:https://konfigurator.modula24.com
Chaque configuration enregistrée dans le configurateur 3D possède un ID de 12 caractères (p. ex. LFKDD5KLP9MG). Avec cet ID, vous pouvez ouvrir la configuration, obtenir le prix, le poids et les dimensions extérieures, la convertir en articles de la boutique (pour le lien panier) et calculer les frais de port (voir API frais de port). Ouvrir le configurateur : https://konfigurator.modula24.com/?load=ID.
GET/checkout-api.php?action=summary&id={id}
Résumé – Prix selon le configurateur, poids, dimensions extérieures (mm) et nomenclature.
En articles de la boutique – Convertit la nomenclature en articles commandables (lines) et renvoie le lien panier prêt à l’emploi (url). Les pièces non disponibles figurent dans missing.
Images de la galerie – Images IA photoréalistes de configurations réelles avec couleur, dimensions extérieures (mm), compartiments et ID de configuration. URL de l’image : https://konfigurator.modula24.com/images/ai/{file}.
import requests
r = requests.get("https://konfigurator.modula24.com/galerie.php",
params={"format": "json"}, timeout=20)
for im in r.json()["images"][:3]:
print(im["cfg"], im["code"], im["dims"])