4pricing-API für Entwickler

Das ist der kürzeste Weg, Ihre 4pricing-Daten auf Ihrer eigenen Website zu sehen. Sie kopieren eine Datei, tragen Ihren Schlüssel darin ein und laden sie auf Ihr Hosting hoch — ohne Framework, ohne Installation.

1. 1

   Schritt 1: API-Schlüssel erstellen

   Melden Sie sich bei panel.4pricing.net an und öffnen Sie Preisüberwachung → API & Schlüssel.

   Klicken Sie auf „Schlüssel generieren“, vergeben Sie einen Namen (zum Beispiel „mein Shop“) und kopieren Sie den Schlüssel, der mit prc_live_ beginnt. Er wird nur ein einziges Mal angezeigt — wenn Sie ihn verlieren, erstellen Sie einen neuen und widerrufen den alten.

   API & Schlüssel im Panel öffnen →

2. 2

   Schritt 2: Fertige Datei kopieren und Schlüssel einfügen

   Kopieren Sie die PHP-Datei unten in einen Texteditor (Notepad, TextEdit oder VS Code) und speichern Sie sie unter dem Namen 4pricing-preise.php.

   php4pricing-preise.php
   <?php
   // =====================================================================
   // HIER IHREN API-SCHLÜSSEL EINFÜGEN (panel.4pricing.net → API & Schlüssel), zwischen den Anführungszeichen
   $apiKey = 'HIER_IHREN_SCHLUESSEL_EINFUEGEN';
   // =====================================================================
   
   header('Content-Type: text/html; charset=utf-8');
   
   function h($text) { return htmlspecialchars((string) $text, ENT_QUOTES, 'UTF-8'); }
   function money($cents) {
       if ($cents === null) { return '—'; }
       return number_format($cents / 100, 2, ',', '.');
   }
   
   if (strpos($apiKey, 'prc_') !== 0) {
       exit('<p>' . h('Der API-Schlüssel fehlt: Öffnen Sie die Datei und fügen Sie Ihren Schlüssel in der markierten Zeile ein.') . '</p>');
   }
   
   $ch = curl_init('https://4pricing.net/api/v1/pricing/groups/');
   curl_setopt_array($ch, [
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_USERAGENT => 'my-shop-integration/1.0',
       CURLOPT_TIMEOUT => 30,
       CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Accept: application/json'],
   ]);
   $body = curl_exec($ch);
   $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   
   if ($body === false) {
       exit('<p>' . h('Verbindung zu 4pricing nicht möglich:' . ' ' . curl_error($ch)) . '</p>');
   }
   if ($status !== 200) {
       $hints = [401 => 'der API-Schlüssel ist falsch oder wurde widerrufen', 402 => 'das Konto hat kein aktives 4pricing-Abonnement (oder nicht genügend Credits)', 429 => 'zu viele Anfragen in einer Minute, versuchen Sie es in einer Minute erneut'];
       $hint = isset($hints[$status]) ? ' — ' . $hints[$status] : '';
       exit('<p>' . h('4pricing hat mit einem Fehler geantwortet' . ' ' . $status . $hint) . '</p><pre>' . h($body) . '</pre>');
   }
   
   $groups = json_decode($body, true);
   $verdicts = [
       'cheapest' => 'Sie sind der Günstigste',
       'too_cheap' => 'Deutlich günstiger als der Markt — Sie können den Preis erhöhen',
       'competitive' => 'Wettbewerbsfähig',
       'too_expensive' => 'Teurer als die meisten Wettbewerber',
       'no_competitors' => 'Noch kein Wettbewerberpreis',
       'no_own_price' => 'Ihr Preis fehlt',
   ];
   
   echo '<!doctype html><html><head><meta charset="utf-8"><title>' . h('Meine überwachten Produkte') . '</title>';
   echo '<style>body{font-family:Arial,sans-serif;margin:24px}table{border-collapse:collapse}';
   echo 'th,td{border:1px solid #ddd;padding:6px 10px;text-align:left}th{background:#f5f5f5}</style>';
   echo '</head><body><h1>' . h('Meine überwachten Produkte') . '</h1>';
   
   if (!$groups) {
       echo '<p>' . h('Sie haben noch keine verglichenen Produkte.') . '</p>';
   } else {
       echo '<table><tr><th>' . h('Produkt') . '</th><th>' . h('SKU') . '</th>';
       echo '<th>' . h('Ihr Preis') . '</th><th>' . h('Günstigster Wettbewerber') . '</th>';
       echo '<th>' . h('Differenz') . '</th><th>' . h('Einschätzung') . '</th></tr>';
       foreach ($groups as $g) {
           $yours = $g['own_price_cents_effective'];
           $cheapest = $g['min_competitor_cents'];
           $diff = '—';
           if ($yours !== null && $cheapest !== null) {
               $diff = ($yours > $cheapest ? '+' : '') . money($yours - $cheapest);
           }
           $verdict = isset($verdicts[$g['verdict']]) ? $verdicts[$g['verdict']] : $g['verdict'];
           echo '<tr><td>' . h($g['name']) . '</td><td>' . h($g['sku']) . '</td>';
           echo '<td>' . money($yours) . '</td><td>' . money($cheapest) . '</td>';
           echo '<td>' . $diff . '</td><td>' . h($verdict) . '</td></tr>';
       }
       echo '</table>';
   }
   echo '</body></html>';
   

   Kopieren

   Ersetzen Sie HIER_IHREN_SCHLUESSEL_EINFUEGEN durch Ihren Schlüssel und behalten Sie die Anführungszeichen drumherum bei. Das ist die einzige Zeile, die Sie ändern müssen.
3. 3

   Schritt 3: Datei hochladen und im Browser öffnen

   Laden Sie 4pricing-preise.php per Dateimanager oder FTP auf Ihre Website hoch, in denselben Ordner wie Ihre Seite (meist public_html).

   Öffnen Sie https://ihre-website/4pricing-preise.php im Browser. Sie sehen eine Tabelle mit jedem verglichenen Produkt: Ihr Preis, den günstigsten Preis der Wettbewerber, die Differenz und die Einschätzung.

Die Datei: Ihre Produkte mit dem günstigsten Wettbewerberpreis auflisten

Die Datei fragt bei 4pricing Ihre verglichenen Produkte ab (GET /groups/) und zeigt sie als Tabelle an. Das Lesen von Daten ist kostenlos und verbraucht keine Credits.

• „Ihr Preis“ ist der Preis, den 4pricing für Sie kennt; „Günstigster Wettbewerber“ ist der niedrigste Preis unter den Wettbewerbern, die Sie überwachen.
• Preise werden in ganzen Währungseinheiten angezeigt (12999 Cent werden zu 129,99); ein Strich (—) bedeutet, dass 4pricing noch keinen Preis hat, nicht dass der Preis null ist.
• Wenn Sie statt der Tabelle eine Fehlermeldung sehen, sagt Ihnen die Meldung, was zu beheben ist: falscher Schlüssel, kein aktives Abonnement oder zu viele Anfragen in einer Minute.

Zweites Rezept: Ihren Preis senden

Nutzen Sie es, wenn 4pricing Ihren eigenen Preis kennen soll, ohne ihn von Ihrer Shopseite zu lesen — zum Beispiel direkt aus der Datenbank Ihres Shops. Das Senden Ihrer Preise ist kostenlos (keine Credits) und zählt nicht zum Limit überwachter URLs Ihres Tarifs.

php4pricing-preis-senden.php
<?php
// =====================================================================
// HIER IHREN API-SCHLÜSSEL EINFÜGEN (panel.4pricing.net → API & Schlüssel), zwischen den Anführungszeichen
$apiKey = 'HIER_IHREN_SCHLUESSEL_EINFUEGEN';
// =====================================================================

// IHRE PRODUKTE: ein Block pro Produkt. price_cents = Preis x 100 (49,99 wird zu 4999).
$products = [
    [
        'sku' => 'T-SHIRT-WEISS-M',
        'name' => 'Weißes T-Shirt, Größe M',
        'url' => 'https://ihr-shop.example/weisses-t-shirt-m',
        'price_cents' => 4999,
        'currency' => 'EUR',
    ],
];

header('Content-Type: text/html; charset=utf-8');

function h($text) { return htmlspecialchars((string) $text, ENT_QUOTES, 'UTF-8'); }

if (strpos($apiKey, 'prc_') !== 0) {
    exit('<p>' . h('Der API-Schlüssel fehlt: Öffnen Sie die Datei und fügen Sie Ihren Schlüssel in der markierten Zeile ein.') . '</p>');
}

$ch = curl_init('https://4pricing.net/api/v1/pricing/own-products/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => 'my-shop-integration/1.0',
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Content-Type: application/json', 'Accept: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['items' => $products], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($body === false) {
    exit('<p>' . h('Verbindung zu 4pricing nicht möglich:' . ' ' . curl_error($ch)) . '</p>');
}
if ($status !== 200) {
    $hints = [401 => 'der API-Schlüssel ist falsch oder wurde widerrufen', 402 => 'das Konto hat kein aktives 4pricing-Abonnement (oder nicht genügend Credits)', 429 => 'zu viele Anfragen in einer Minute, versuchen Sie es in einer Minute erneut'];
    $hint = isset($hints[$status]) ? ' — ' . $hints[$status] : '';
    exit('<p>' . h('4pricing hat mit einem Fehler geantwortet' . ' ' . $status . $hint) . '</p><pre>' . h($body) . '</pre>');
}

$result = json_decode($body, true);
echo '<h1>' . h('An 4pricing gesendete Preise') . '</h1>';
echo '<p>' . h('Neu angelegte Produkte:') . ' ' . (int) $result['created'] . '</p>';
echo '<p>' . h('Aktualisierte Produkte:') . ' ' . (int) $result['updated'] . '</p>';
if (!empty($result['errors'])) {
    echo '<p>' . h('Zeilen mit Problemen:') . '</p><ul>';
    foreach ($result['errors'] as $error) {
        echo '<li>' . h($error) . '</li>';
    }
    echo '</ul>';
}

• Speichern Sie die Datei als 4pricing-preis-senden.php, fügen Sie Ihren Schlüssel ein, passen Sie die Produktzeilen an, laden Sie sie hoch und öffnen Sie sie einmal: Die Seite zeigt, wie viele Produkte angelegt und wie viele aktualisiert wurden.
• Jede Anfrage kann bis zu 2.000 Produkte enthalten; eine fehlerhafte Zeile wird gemeldet, die übrigen werden trotzdem gespeichert. Wenn Sie dieselbe sku erneut senden, wird der Preis aktualisiert.

Dieselben Aufrufe mit curl

Wenn Sie das Terminal bevorzugen: Diese zwei Befehle tun genau dasselbe wie die beiden PHP-Dateien:

bash
curl https://4pricing.net/api/v1/pricing/groups/ \
  -H "X-API-Key: HIER_IHREN_SCHLUESSEL_EINFUEGEN"

bash
curl -X POST https://4pricing.net/api/v1/pricing/own-products/bulk \
  -H "X-API-Key: HIER_IHREN_SCHLUESSEL_EINFUEGEN" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"T-SHIRT-WEISS-M","name":"Weißes T-Shirt, Größe M","url":"https://ihr-shop.example/weisses-t-shirt-m","price_cents":4999,"currency":"EUR"}]}'

• Jede Anfrage trägt Ihren Schlüssel im Header X-API-Key. Auch Authorization: Bearer prc_live_… funktioniert (nur für Schlüssel, die mit prc_ beginnen).
• Es gibt keine Scopes: Ein Schlüssel kann alles in Ihrem 4pricing-Konto lesen und ändern. Erstellen Sie pro Integration einen eigenen Schlüssel (Shop, ERP, Bericht), damit Sie einen widerrufen können, ohne die anderen zu stoppen.
• Ein fehlender, falscher oder widerrufener Schlüssel erhält 401. Ein Widerruf wirkt sofort. Zu viele ungültige Schlüssel in einer Minute erhalten 429.
• Schlüssel werden ausschließlich im Panel erstellt, aufgelistet und widerrufen (Preisüberwachung → API & Schlüssel); die API selbst kann keine Schlüssel verwalten. Zum Erstellen eines Schlüssels ist ein aktives 4pricing-Abonnement erforderlich.

http
X-API-Key: prc_live_…
# or
Authorization: Bearer prc_live_…

• Jeder Pfad in dieser Dokumentation ist relativ zur Basis-URL — /groups/ bedeutet https://4pricing.net/api/v1/pricing/groups/.
• Anfragen und Antworten sind JSON (Content-Type: application/json).
• Beträge sind ganze Zahlen in der kleinsten Einheit (Cent): price_cents = 12999 bedeutet 129,99. Prozentwerte werden in Basispunkten angegeben (100 = 1 %).
• Ein unbekannter Wert ist null, niemals 0 — zeigen Sie ihn als „—“ an.
• Sammlungen werden mit einem abschließenden Schrägstrich aufgerufen (/products/, /groups/, /insights/).
• Paginierte Listen liefern die Gesamtzahl im Header X-Total-Count (zum Beispiel GET /products/?skip=0&limit=200).
• Senden Sie einen User-Agent-Header, der Ihre Integration benennt (zum Beispiel my-shop-integration/1.0). Die Firewall vor der API antwortet auf manche generischen Bibliotheks-Standardwerte, etwa Python-urllib, mit 403.

Anfragelimit

• 60 Anfragen pro Minute und KONTO, in einem gleitenden Fenster — alle Schlüssel desselben Kontos teilen sich dieselben 60.
• Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (die Fensterlänge in Sekunden).
• Wird das Limit überschritten, erhalten Sie 429 mit einem Retry-After-Header (Sekunden). Warten Sie so lange und versuchen Sie es dann erneut — die Beispiele unten erledigen das für Sie.

http
HTTP/2 200
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
x-ratelimit-reset: 60

HTTP/2 429
retry-after: 60
{"detail":"Rate limit exceeded"}

Abonnement und Plangrenzen

• Die API erfordert ein aktives 4pricing-Abonnement; ohne eines erhält jede Anfrage 402 mit dem Code plan_required.
• Jeder Tarif enthält die API mit denselben Limits wie das Panel. Wenn Sie beim Hinzufügen oder Reaktivieren ein Limit überschreiten, erhalten Sie 402 mit dem Code plan_limit und einer Meldung, die nennt, um welches Limit es geht.

Das Lesen einer Shopseite kostet Credits aus dem Guthaben Ihres Kontos. Die folgenden Aufrufe prüfen das Guthaben, BEVOR etwas gelesen wird: Reicht es nicht, erhalten Sie 402 insufficient_credits, und lässt sich das Guthaben gerade nicht abrufen, erhalten Sie 503 credit_wallet_unavailable (später erneut versuchen). In beiden Fällen wird nichts gelesen und nichts berechnet.

Aufrufe, die Credits verbrauchen

Kostenlose Aufrufe

• Jeder lesende Aufruf (GET): Produkte, Gruppen, Vergleiche, Verlauf, Alarme, Insights, Briefings, Credits, Statistiken.
• POST /own-products/ und POST /own-products/bulk — Ihre eigenen Preise.
• POST /sales/bulk — Ihre Verkäufe.
• Alarme, Einstellungen, Bestätigungen und alles andere, was keine Shopseite liest.

• Auch die geplante Überwachung der URLs, die Sie verfolgen, verbraucht bei jeder Prüfung Credits; GET /credits/ zeigt Ihr Guthaben und die Prognose.
• POST /products/import fügt viele URLs auf einmal hinzu, ohne sie sofort zu lesen: Sie werden von der geplanten Überwachung geprüft und dort berechnet.

Jede Operation, die ein Schlüssel erreichen kann, gruppiert nach ihrem Zweck. Die OpenAPI-Spezifikation beschreibt jede einzelne Feld für Feld, mit den genauen Request- und Response-Bodys.

Ihre eigenen Preise

Teilen Sie 4pricing Ihren Preis direkt mit, ohne Ihre Shopseite zu lesen. Kostenlos.

Verglichene Produkte (Gruppen)

Eine Gruppe ist ein Produkt von Ihnen zusammen mit den Wettbewerberseiten, die dasselbe verkaufen. Sie enthält die Einschätzung und den empfohlenen Preis.

Überwachte URLs

Eine Zeile pro Seitenadresse, die 4pricing liest, Ihre eigene oder die eines Wettbewerbers (Rolle own oder competitor).

Live-Suche

Den Preis eines Produkts sofort bei Händlern nachschlagen.

Alarme

Preisregeln und der Posteingang der ausgelösten Alarme.

Credits

Guthaben, Prognose und jede Credit-Bewegung.

Ihre Verkäufe

Tägliche Verkäufe pro Produkt, mit denen der Wert jeder Chance berechnet wird. Kostenlos.

Insights, Chancen und Briefings

Was sich geändert hat, warum es wichtig ist und was zu tun ist — dazu das tägliche Briefing.

Preisaktionen

Preisänderungen, die vorgeschlagen, gesendet, angewendet oder zurückgesetzt wurden. Über die API können Sie sie lesen und die per Webhook empfangenen bestätigen.

Einstellungen

Kontoeinstellungen, einschließlich Webhook-Adresse und Secret.

Statistiken

Kontoübersicht und Zustand der Preisprüfungen.

53 endpoints · https://4pricing.net/api/v1/pricing/openapi.json

Manche Dinge bleiben bewusst im Panel, wo eine angemeldete Person entscheidet. Über die API antworten diese Pfade mit 404:

4pricing kann Ereignisse an eine Adresse von Ihnen senden (einen Webhook): Bei jedem Vorfall wird ein JSON-POST abgesetzt, damit Ihr System nicht ständig nachfragen muss.

Es gibt eine Webhook-Adresse pro Konto; jede Ereignisart geht dorthin. Unterscheiden Sie sie über das Feld event — der Alarm ist das einzige Ereignis ohne dieses Feld.

Aktivieren

• Setzen Sie alert_webhook_url (eine öffentliche http/https-Adresse auf Port 80 oder 443), alert_webhook_secret und alert_webhook_enabled: true — im Panel oder mit PUT /settings/.
• Eine Adresse, die auf ein privates oder internes Netz auflöst, wird mit 422 abgelehnt. Weiterleitungen werden nicht verfolgt.
• Für briefing.ready aktivieren Sie zusätzlich briefing_webhook_enabled. price.apply und price.revert werden nur für Gruppen gesendet, die mit store_kind = webhook mit Ihrem Shop verknüpft sind, und nur wenn ein Secret gesetzt ist.

bash
curl -X PUT https://4pricing.net/api/v1/pricing/settings/ \
  -H "X-API-Key: HIER_IHREN_SCHLUESSEL_EINFUEGEN" \
  -H "Content-Type: application/json" \
  -d '{"alert_webhook_url":"https://your-shop.example/4pricing-webhook.php","alert_webhook_secret":"IHR_WEBHOOK_SECRET","alert_webhook_enabled":true,"briefing_webhook_enabled":true}'

Ereignisse

Header jeder Webhook-Anfrage

Signatur prüfen

Berechnen Sie die Signatur aus dem Timestamp-Header und dem ROHEN Body, den Sie erhalten haben, neu, vergleichen Sie sie in konstanter Zeit und prüfen Sie den Zeitstempel. Erst dann verarbeiten Sie das Ereignis. Antworten Sie mit einem beliebigen 2xx, wenn Sie es angenommen haben.

php
<?php
$secret = 'IHR_WEBHOOK_SECRET';

// Den ROHEN Body verwenden, genau so, wie er empfangen wurde — kein neu kodiertes JSON
$body = file_get_contents('php://input');
$timestamp = isset($_SERVER['HTTP_X_4PRICING_TIMESTAMP']) ? $_SERVER['HTTP_X_4PRICING_TIMESTAMP'] : '';
$signature = isset($_SERVER['HTTP_X_4PRICING_SIGNATURE']) ? $_SERVER['HTTP_X_4PRICING_SIGNATURE'] : '';
$expected = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $body, $secret);

// Falsche Signatur oder älter als 5 Minuten: ablehnen
if (!hash_equals($expected, $signature) || abs(time() - (int) $timestamp) > 300) {
    http_response_code(401);
    exit;
}

$event = json_decode($body, true);
if (isset($event['event']) && ($event['event'] === 'price.apply' || $event['event'] === 'price.revert')) {
    // new_price_cents auf das Produkt in Ihrem Shop anwenden (Zuordnung über sku oder store_product_id)
    // $event['group']['sku'], $event['new_price_cents'], $event['currency']
    // Anschließend bestätigen: POST /actions/{action_id}/confirm mit Ihrem API-Schlüssel
}
http_response_code(200);
echo 'ok';

javascript
// Node.js, no package needed
const http = require("http");
const crypto = require("crypto");
const SECRET = process.env.WEBHOOK_SECRET; // IHR_WEBHOOK_SECRET

http.createServer((req, res) => {
  const chunks = [];
  req.on("data", (c) => chunks.push(c));
  req.on("end", () => {
    // Den ROHEN Body verwenden, genau so, wie er empfangen wurde — kein neu kodiertes JSON
    const body = Buffer.concat(chunks);
    const ts = String(req.headers["x-4pricing-timestamp"] || "");
    const sig = String(req.headers["x-4pricing-signature"] || "");
    const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(ts + ".").update(body).digest("hex");
    const fresh = Math.abs(Date.now() / 1000 - Number(ts)) <= 300;
    const same = sig.length === expected.length && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
    if (!same || !fresh) {
      // Falsche Signatur oder älter als 5 Minuten: ablehnen
      res.writeHead(401);
      return res.end();
    }
    const event = JSON.parse(body.toString("utf8"));
    if (event.event === "price.apply" || event.event === "price.revert") {
      // new_price_cents auf das Produkt in Ihrem Shop anwenden (Zuordnung über sku oder store_product_id)
      // Anschließend bestätigen: POST /actions/{action_id}/confirm mit Ihrem API-Schlüssel
    }
    res.writeHead(200);
    res.end("ok");
  });
}).listen(3000);

python
# Python 3, standard library only
import hashlib
import hmac
import time

SECRET = "IHR_WEBHOOK_SECRET"


def is_valid(raw_body: bytes, timestamp: str, signature: str) -> bool:
    # Den ROHEN Body verwenden, genau so, wie er empfangen wurde — kein neu kodiertes JSON
    if not timestamp.isdigit() or abs(time.time() - int(timestamp)) > 300:
        return False
    expected = "sha256=" + hmac.new(
        SECRET.encode(), timestamp.encode() + b"." + raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

Zustellung und Wiederholungen

• Alarme: Bei einem Verbindungs- oder DNS-Fehler, 429 oder 5xx wird die Anfrage mit exponentiellem Backoff wiederholt, höchstens 5 Versuche. Jedes andere 4xx ist endgültig.
• Wurde die Anfrage gesendet, aber innerhalb von 10 Sekunden keine Antwort empfangen, wird sie nicht erneut gesendet (um ein Duplikat zu vermeiden) — in seltenen Fällen kann dennoch ein Duplikat eintreffen, deduplizieren Sie daher über event_id.
• price.apply und price.revert werden nur einmal gesendet: Schlägt die Zustellung fehl, wird die Aktion auf failed gesetzt. Deduplizieren Sie über action_id.
• briefing.ready wird einmal am Tag gesendet.

Einen angewendeten Preis bestätigen

• Ein price.apply gilt erst als angewendet, wenn Ihr System es meldet. Nachdem Sie den Preis in Ihrem Shop geändert haben, rufen Sie POST /actions/{action_id}/confirm mit Ihrem API-Schlüssel auf: Die Aktion wechselt von „gesendet“ zu „angewendet“.
• Doppeltes Bestätigen schadet nicht — eine bereits angewendete Aktion wird unverändert zurückgegeben.

bash
curl -X POST https://4pricing.net/api/v1/pricing/actions/ACTION_ID/confirm \
  -H "X-API-Key: HIER_IHREN_SCHLUESSEL_EINFUEGEN"

Beispiel-Bodys

json · price.apply
{
  "event": "price.apply",
  "action_id": "8d0f2c4e-0b7a-4f7e-9d61-3c2b1a0e9f55",
  "tenant_id": "…",
  "group": {
    "id": "2fa912df-440c-4ddf-896a-5d558d56085f",
    "name": "Canon RF 50mm F1.8 STM",
    "sku": "4515C005AA",
    "ean": "4549292181623",
    "store_product_id": "1042"
  },
  "old_price_cents": 124900,
  "new_price_cents": 118699,
  "currency": "RON",
  "reason_code": "undercut",
  "mode": "manual",
  "confirm": { "method": "POST", "path": "/api/v1/pricing/actions/8d0f2c4e-0b7a-4f7e-9d61-3c2b1a0e9f55/confirm" }
}

json · alert
{
  "event_id": 18342,
  "alert_id": "c1b5…",
  "alert_type": "competitor_undercut",
  "tenant_id": "…",
  "message_code": "competitor_undercut",
  "message": "…",
  "message_params": { "…": "…" },
  "price_cents": 118990,
  "currency": "RON",
  "triggered_at": "2026-10-13T07:05:12",
  "product": { "id": "…", "name": "…", "url": "https://…", "retailer": "…", "current_price_cents": 118990, "in_stock": true },
  "group": { "id": "…", "name": "Canon RF 50mm F1.8 STM", "sku": "4515C005AA" },
  "panel_url": "https://panel.4pricing.net/…"
}

Fehler kommen mit dem passenden HTTP-Status und einem JSON-Body {"detail": …}. detail ist ein Text, ein Objekt mit einem Code, den Sie in Ihrem Programm behandeln können, oder — bei 422 — die Liste der ungültigen Felder.

Fehler-Bodys

json
{"detail": "Invalid or missing API key"}
{"detail": {"code": "plan_required", "message": "…"}}
{"detail": {"code": "insufficient_credits", "message": "…"}}
{"detail": [{"loc": ["body", "price_cents"], "msg": "…", "type": "…"}]}

Dieselbe Abfrage in vier Sprachen, mit Pause und erneutem Versuch bei 429, anschließend das Senden von Verkäufen. Ersetzen Sie HIER_IHREN_SCHLUESSEL_EINFUEGEN durch Ihren Schlüssel (oder setzen Sie die Umgebungsvariable PRICING_API_KEY).

Node.js: verglichene Produkte lesen

javascript
// Node.js 18+ (fetch is built in, no package needed)
const API_KEY = process.env.PRICING_API_KEY; // HIER_IHREN_SCHLUESSEL_EINFUEGEN
const BASE = "https://4pricing.net/api/v1/pricing";

async function call(path, options = {}) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch(BASE + path, {
      ...options,
      headers: { "X-API-Key": API_KEY, "Content-Type": "application/json", ...(options.headers || {}) },
    });
    if (res.status === 429) {
      // Über 60 Anfragen/Minute: so viele Sekunden warten, wie Retry-After angibt, dann erneut versuchen
      const wait = Number(res.headers.get("Retry-After") || 60);
      await new Promise((r) => setTimeout(r, wait * 1000));
      continue;
    }
    if (!res.ok) throw new Error(res.status + " " + (await res.text()));
    return res.status === 204 ? null : res.json();
  }
  throw new Error("rate limited");
}

async function main() {
  // Ihre verglichenen Produkte: Ihr Preis, der günstigste Wettbewerber, die Einschätzung
  const groups = await call("/groups/");
  for (const g of groups) {
    console.log(g.name, g.own_price_cents_effective, g.min_competitor_cents, g.verdict);
  }
}

main().catch((err) => {
  console.error(err.message);
  process.exit(1);
});

Python: verglichene Produkte lesen

python
# Python 3, standard library only
import json
import os
import time
import urllib.error
import urllib.request

API_KEY = os.environ["PRICING_API_KEY"]  # HIER_IHREN_SCHLUESSEL_EINFUEGEN
BASE = "https://4pricing.net/api/v1/pricing"


def call(path, method="GET", payload=None):
    data = json.dumps(payload).encode() if payload is not None else None
    for _ in range(3):
        req = urllib.request.Request(BASE + path, data=data, method=method, headers={
            "X-API-Key": API_KEY, "Content-Type": "application/json", "Accept": "application/json",
            # Setzen Sie Ihren eigenen User-Agent: Der Standardwert mancher HTTP-Bibliotheken (Python urllib) wird mit 403 blockiert
            "User-Agent": "my-shop-integration/1.0",
        })
        try:
            with urllib.request.urlopen(req, timeout=30) as res:
                body = res.read()
                return json.loads(body) if body else None
        except urllib.error.HTTPError as err:
            if err.code == 429:
                # Über 60 Anfragen/Minute: so viele Sekunden warten, wie Retry-After angibt, dann erneut versuchen
                time.sleep(int(err.headers.get("Retry-After", "60")))
                continue
            raise
    raise RuntimeError("rate limited")


# Ihre verglichenen Produkte: Ihr Preis, der günstigste Wettbewerber, die Einschätzung
for g in call("/groups/"):
    print(g["name"], g["own_price_cents_effective"], g["min_competitor_cents"], g["verdict"])

curl: tägliche Verkäufe senden

bash
curl -X POST https://4pricing.net/api/v1/pricing/sales/bulk \
  -H "X-API-Key: HIER_IHREN_SCHLUESSEL_EINFUEGEN" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"sku":"T-SHIRT-WEISS-M","day":"2026-10-12","units_sold":7,"revenue_cents":34993}]}'

PHP: tägliche Verkäufe senden

php
<?php
$apiKey = 'HIER_IHREN_SCHLUESSEL_EINFUEGEN';

// Tägliche Verkäufe pro Produkt (nach sku oder group_id), bis zu 2.000 Zeilen pro Anfrage
$rows = [
    ['sku' => 'T-SHIRT-WEISS-M', 'day' => '2026-10-12', 'units_sold' => 7, 'revenue_cents' => 34993],
];

$ch = curl_init('https://4pricing.net/api/v1/pricing/sales/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => 'my-shop-integration/1.0',
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['rows' => $rows]),
]);
$body = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . ' ' . $body;   // 200 {"upserted": 1, "skipped": []}