API und Entwickler: ApoGuru Tool in eigene Shop-Prozesse einbinden
Nicht jeder Shop ist ein Standardsystem. Für individuelle Lösungen stellt ApoGuru Tool eine kleine, bewusst einfache Schnittstelle bereit. Sie ist dokumentiert und lässt sich zügig anbinden.
Auf einen Blick
- Drei Endpunkte, JSON
- Vorausfüllen nur mit Einwilligung und freigegebener Domain
- Einmal-Token, 15 Minuten gültig
- Webhooks und Status-Seite sind in Planung
Die drei Endpunkte
| Endpunkt | Zweck |
|---|---|
GET /api/config?p=ID |
Überschrift, Unterzeile, Button-Text, Farbe Ihrer Apotheke |
POST /api/event |
anonyme Ereignisse: angezeigt, geklickt, geschlossen |
POST /api/prefill |
Vorausfüllen vorbereiten, Rückgabe: Link mit Einmal-Token |
Konfiguration lesen
Die Konfiguration ist öffentlich lesbar, so können Sie den Hinweis in Ihrer eigenen Oberfläche nachbauen.
Ereignisse melden
Mit type shown, click oder dismiss. Es werden keine personenbezogenen Daten gespeichert.
Vorausfüllen
Die Anfrage muss von einer freigegebenen Domain kommen und consent: true enthalten. Als Antwort erhalten Sie die Adresse, auf die Sie Ihre Kund:innen weiterleiten.
Sicher gedacht
- Antworten nur für freigegebene Domains
- Daten verschlüsselt, nie in einer URL
- Token gilt einmalig und 15 Minuten
- Anfragen sind mengenbegrenzt
Betrieb und Geschwindigkeit
Server in Deutschland
ApoGuru Tool läuft auf einem Server in Falkenstein.
Klein und asynchron
Das Embed-Script ist wenige Kilobyte klein und lädt asynchron. Wer die Schnittstelle direkt nutzt, braucht es gar nicht.
Noch nicht dabei
- Webhooks
- Änderungsübersicht
- System-Status
Diese Punkte veröffentlichen wir erst, wenn sie bereitstehen.
Häufige Fragen
Wo finde ich die Beschreibung?
Auf apogurutool.de/api.
Reicht für Standard-Shops die Zeile Code?
Ja, siehe Einbindung in einer Zeile.
Beispielablauf einer Integration
1. Konfiguration holen
GET https://apogurutool.de/api/config?p=IHRE_ID2. Ereignis melden
POST /api/event
{ "partner": "IHRE_ID", "type": "shown" }3. Vorausfüllen vorbereiten
POST /api/prefill
{ "partner": "IHRE_ID", "consent": true,
"data": { "vorname": "Max", "email": "max@example.de" } }Die Antwort enthält eine Adresse mit Einmal-Token, auf die Sie die Kund:in weiterleiten.
Fehlercodes
| Code | Bedeutung |
|---|---|
| 400 | Einwilligung fehlt oder Anfrage ungültig |
| 403 | Domain nicht freigegeben |
| 404 | Partner-ID unbekannt |
| 429 | zu viele Anfragen, kurz warten |
Ein Hinweis zur Einwilligung
Rufen Sie die Vorausfüll-Schnittstelle nur auf, wenn Ihre Kund:in aktiv zugestimmt hat. Ohne consent: true antwortet die Schnittstelle nicht.
Jetzt starten
- Apotheke unter apogurutool.de/anmelden anmelden
- Im Testmodus einbinden und ausprobieren
- Freischaltung für den Livebetrieb beantragen, ApoGuru meldet sich
Fragen? Schreiben Sie uns über das Kontaktformular.
Bestellungen und Rezepte im Blick: Partner-Portal, App und optionale ERP-Anbindung
ApoGuru Tool für Shopware 6: Plugin und Template-Erweiterung
ApoGuru Tool für Shopify: Anleitung für den Rezept-Hinweis
ApoGuru Tool für WooCommerce: Plugin installieren und Partner-ID eintragen
Ein Rezept-Hinweis für Ihr gesamtes Sortiment: Extrakte, Blüten, Vapes und mehr
Mehr Umsatz im eigenen Shop: Kund:innen nach der Bestellung nicht aus den Augen verlieren
