Dokumentation
Benachrichtigungen und Webhooks
Wenn auf Ihrer Auktion etwas geschieht — ein Los schließt, ein Bieter wird überboten, eine Schlusszeit verschiebt sich —, sagt Auction Experts es Ihrem System sofort, ohne dass Sie danach fragen müssen.
Die Alternative, und das, was die meisten Systeme ohne dies tun, ist Abfragen: alle dreißig Sekunden „hat sich etwas geändert?“ fragen, für immer, fast immer „nein“ hören — und trotzdem eine halbe Minute hinterherhinken. Sie sagen uns einmal, wo wir Sie erreichen, und wir erreichen Sie.
Wir sagen Ihnen, was sich geändert hat; Sie holen sich, was Sie brauchen
Eine Benachrichtigung trägt zwei Dinge: was geschehen ist und woran es geschehen ist. Wir rufen eine Adresse auf, die Sie wählen, übergeben den Bezeichner des betroffenen Loses oder der betroffenen Auktion und authentifizieren uns mit einem zwischen uns vereinbarten Geheimnis. Keine Losbeschreibung, kein Preis, kein Bietername.
https://ihre-seite.example/webhook/lot-ended/3f2504e0-4f89-11d3-9a0c-0305e82c3301Sonst nichts. Ihr System fragt dann unsere API nach den Details, die es braucht.
Das liest sich wie eine Einschränkung und ist das Gegenteil. Der Grund ist Veralterung. Würden wir den Zuschlagspreis in die Benachrichtigung packen, wäre dieser Preis eine Momentaufnahme aus dem Augenblick des Versands — und bis sie ankommt, gelesen und verarbeitet ist, kann er sich bewegt haben. Ihr System würde auf Basis einer Zahl entscheiden, die bereits überholt ist, ohne es wissen zu können.
Weil wir nur einen Bezeichner senden, fragt Ihr System nach dem aktuellen Stand, und was es bekommt, stimmt jetzt. Auf veraltete Daten zu reagieren ist unmöglich, weil wir nie welche senden.
Es gibt einen zweiten Vorteil, der sich über Jahre statt über Tage zeigt. Die meisten Benachrichtigungssysteme sammeln Felder an — jede Integration will noch eine Angabe dazu, und jede Ergänzung ist ein weiterer Wert, der leise von der Wirklichkeit abweichen kann. Unseres kann nicht abweichen, weil nichts darin ist, das abweichen könnte. Deshalb hat das Format nie eine Version gebraucht.
Worüber wir Sie informieren können
Achtzehn Benachrichtigungen. Jede wird für Ihr Auktionshaus einzeln freigeschaltet — Sie erhalten die, um die Sie gebeten haben, nicht standardmäßig alle achtzehn. Jede hat außerdem einen technischen Bezeichner, den wir bei der Freischaltung mit Ihnen bestätigen; die Beschreibungen unten sind der Vertrag.
Bieten — die zeitkritischen
| Was geschehen ist | Warum es zählt |
|---|---|
| Eine Schlusszeit wurde nach hinten verschoben | In den letzten Momenten ist ein Gebot eingegangen, das Los bleibt also länger offen. Ihr Countdown stimmt jetzt nicht mehr. Das ist das Dringendste, was wir senden. |
| Jemand wurde überboten | Treibt den Hinweis „Sie wurden überboten“, der einen Bieter zurückholt. Wird auch bei automatischen Maximalgeboten ausgelöst, nicht nur bei manuellen. |
| Ein Gebot wurde angenommen | Dieser Bieter führt jetzt. Für Live-Ranglisten und Gebotszähler. |
| Ein Bieter hat die Gebotsmaske geöffnet | Ein Interessensignal, noch vor jedem tatsächlichen Gebot. |
Lose und Auktionen, die öffnen und schließen
| Was geschehen ist | Warum es zählt |
|---|---|
| Ein Los wurde geschlossen | Auf diesem Los wird nicht mehr geboten. Löst Ihre Nachbearbeitung aus: Ergebnisseiten, Rechnungsstellung, Benachrichtigung des Gewinners. |
| Das letzte Los einer Auktion wurde geschlossen | Die Auktion ist wirklich beendet und nicht nur über ihre geplante Endzeit hinaus. Bei gestaffelten Schlusszeiten können dazwischen Stunden liegen. |
| Ein Los wurde zum Bieten geöffnet | Gehen Sie auf Ihrer Seite im selben Moment live wie wir. |
| Eine Auktion wurde zur Ansicht geöffnet | Der Katalog ist öffentlich. Zeit, ihn zu bewerben. |
| Eine Auktion hat ihre Endzeit erreicht | Der geplante Schluss, unabhängig davon, ob jedes Los bereits beendet ist. |
| Eine Erinnerung ist fällig geworden | Jemand wollte vor dem Schluss eines Loses benachrichtigt werden, und jetzt ist der Zeitpunkt. |
Katalogänderungen
| Was geschehen ist | Warum es zählt |
|---|---|
| Ein Los wurde angelegt, geändert oder entfernt | Hält Ihren Katalog mit unserem im Gleichschritt, ohne nächtlichen Neuimport. Dem Volumen nach ist das mit weitem Abstand das Häufigste, was wir senden. |
| Eine Auktion wurde angelegt | Es gibt eine neue Auktion. |
| Eine Auktion wurde geändert | Termine, Beschreibung, Bedingungen — alles an der Auktion selbst. |
Registrierungen
| Was geschehen ist | Warum es zählt |
|---|---|
| Jemand hat mit der Registrierung begonnen | Der Anfang des Trichters — und die einzige Möglichkeit, eine abgebrochene Anmeldung zu erkennen: Aufgeben erzeugt keine eigene Benachrichtigung. |
| Eine E-Mail-Adresse wurde bestätigt | Der Link wurde geklickt. Für die meisten Auktionshäuser ist damit die Registrierung abgeschlossen. |
| Eine Telefonnummer wurde verifiziert | Nur dort, wo die SMS-Verifizierung eingeschaltet ist. |
| Ein Los wurde auf eine Merkliste gesetzt | Das deutlichste Interessensignal überhaupt. Speist „Ihre beobachteten Lose schließen bald“. |
| Ein Los wurde von einer Merkliste entfernt | Interesse zurückgezogen — dasselbe Signal, umgekehrt. |
Was passiert, wenn Ihre Seite ausfällt
Diesen Teil sollte man genau lesen, denn es ist der Teil, den die meisten Systeme falsch machen.
Wir schreiben es auf, bevor wir es senden. Die Benachrichtigung wird zuerst in unserer Datenbank festgehalten und erst danach übertragen. Geht danach etwas schief, liegt der Eintrag weiterhin bereit.
Wir versuchen es sofort — der erste Versuch erfolgt binnen Sekunden nach dem Ereignis.
Schlägt er fehl, versuchen wir es weiter. Sieben Versuche in wachsenden Abständen: 30 Sekunden, 2 Minuten, 10 Minuten, 1 Stunde, 6 Stunden, 24 Stunden. Das deckt rund 31 Stunden ab — bewusst so gewählt, dass eine Seite, die über Nacht oder über ein Wochenende ausfällt, nach ihrer Rückkehr trotzdem alles Versäumte bekommt.
Ein separater Durchlauf läuft jede Minute und sucht nach allem, was durch den schnellen Weg gefallen ist. Ein Fehlschlag dort kostet eine kurze Verzögerung, nie die Benachrichtigung selbst.
Zwei Antworten beenden die Wiederholungen vorzeitig. Meldet Ihr System, dass die Adresse nicht existiert, oder weist es unsere Zugangsdaten zurück, hören wir auf, statt siebenmal dagegenzulaufen — das sind falsche Einstellungen, und den Aufruf zu wiederholen behebt sie nicht.
Eine Wiederholung ist möglich und unschädlich
Dieselbe Benachrichtigung kann zweimal ankommen. Kommt eine Zustellung an, geht aber die Bestätigung an uns verloren, versuchen wir es erneut. Das ist Absicht: lieber zweimal als nie.
Es ist unschädlich, weil jede Benachrichtigung einen Bezeichner trägt — dieselbe zweimal zu verarbeiten führt zum selben Ergebnis. Schlüsseln Sie Ihre Verarbeitung auf diesen Bezeichner und ignorieren Sie, was Sie schon verarbeitet haben.
Auch die Reihenfolge ist nicht garantiert. Eine Benachrichtigung, die eine Stunde in der Wiederholungsleiter verbracht hat, kommt nach solchen an, die seither gesendet wurden — die Ankunftsreihenfolge ist also nicht die Ereignisreihenfolge. Das sichere Muster folgt aus der ersten Regel dieser Seite: Die Benachrichtigung sagt Ihnen, dass sich etwas geändert hat, und Sie holen den aktuellen Stand über die API — wenden Sie nie Inhalte von Benachrichtigungen in der Reihenfolge ihres Eintreffens an.
Eine Benachrichtigung freischalten
Sagen Sie uns, wohin wir senden sollen, und wir schalten sie frei. Sie greift beim allernächsten Anlass — kein Software-Release, keine Ausfallzeit, und auf Ihrer Seite ist außer dem Endpunkt selbst nichts auszurollen.
Eine Selbstbedienungsmaske dafür gibt es heute nicht; es ist eine Konfigurationsänderung, die unser Team vornimmt. In der Praxis geht das schnell, und es ist besser, das offen zu sagen, als ein Dashboard anzudeuten, das nicht existiert.
Drei Dinge, die man verstanden haben sollte
Der Countdown, der sich selbst korrigiert. Acht Sekunden vor dem Schluss eines Loses geht ein Gebot ein, also verschiebt sich die Schlusszeit. Jede andere Seite, die dieses Los zeigt, zählt jetzt auf den falschen Moment herunter — es sei denn, sie erfährt davon. Wir sagen es Ihnen binnen Sekunden. Auf jeder Auktion mit automatischer Verlängerung passiert das regelmäßig.
Aufhören zu fragen, anfangen, informiert zu werden. Vorher: Ihr System fragt alle dreißig Sekunden „etwas Neues?“, tausendfach am Tag, hört fast immer nein und ist trotzdem eine halbe Minute im Rückstand. Nachher: Stille, bis tatsächlich etwas passiert. Weniger Last auf beiden Seiten, und schneller.
Über Nacht geht nichts verloren. Ihre Seite fällt um zwei Uhr nachts aus. Unsere hört nicht auf und gibt nicht auf — sie hält alles fest und versucht es den nächsten Tag und ein Stück darüber hinaus weiter. Wenn Sie zurück sind, bekommen Sie alles.