Public Embed/API Dokumentation

Technische Integrationshilfe für iFrame- und Script-Embeds, Partner-Registration und Attribution-Events.

Zum Embed-Generator Zum Partner-Dashboard

Endpunkte

GET /api/embed/calculator?slug=...&theme=light|dark&height=740
GET /api/embed/calculator?format=script
POST /api/partner/register
POST /api/partner/analytics
GET /api/partner/analytics (optional mit ?partnerId=...)

iFrame Embed Beispiel

<iframe
  src="https://rechner-portal.de/finanzen/kreditrechner?embed=1&theme=light"
  loading="lazy"
  width="100%"
  height="740"
  style="border:1px solid #d5d9e2;border-radius:12px"
  referrerpolicy="strict-origin-when-cross-origin"
></iframe>

Script Embed Beispiel

<script async src="https://rechner-portal.de/api/embed/calculator?format=script"></script>
<div data-rp-calculator="https://rechner-portal.de/finanzen/kreditrechner?embed=1&theme=light"></div>

Partner Registrierung

curl -X POST https://rechner-portal.de/api/partner/register \
  -H "Content-Type: application/json" \
  -d '{
    "organization": "Muster Verlag",
    "domain": "beispiel.de",
    "useCase": "Ratgeber Landingpages"
  }'

Attribution Event melden

curl -X POST https://rechner-portal.de/api/partner/analytics \
  -H "Content-Type: application/json" \
  -d '{
    "partnerId": "muster-verlag-ab12cd",
    "eventType": "embed_calculation_completed",
    "calculatorSlug": "kreditrechner",
    "metadata": { "channel": "article_sidebar" }
  }'