Eine Datei statt vieler Anfragen

Ihr legt eure Angebote als Datei bereit, wir holen sie jede Nacht ab. Was ihr dafür tut: eine Datei bereitstellen, die ihr ohnehin habt.

Was in der Datei stehen muss

Eine Zeile je Objekt, und die Spalten dürfen heißen, wie sie bei euch heißen. Welches Feld von euch welches von uns wird, tragen wir einmal ein.

Angabe	Was gilt
Format	CSV, JSON, JSONL, XML
Adresse	Muss mit `https` anfangen und von außen erreichbar sein. Ein Zugang über Benutzer und Passwort oder eine Kopfzeile ist möglich.
Wie oft	Täglich, Wöchentlich
Pflichtfelder	`category_id, title, excerpt, description, age_from, age_to, postal_code, city, state`

Was in jedes Feld gehört, steht auf der Seite mit den Feldern. Es sind dieselben wie bei der Schnittstelle.

Ein Objekt wird ein Eintrag

Ein Haus mit vierzig Terminen bleibt ein Eintrag mit einem Zeitraum. Vierzig Einträge dazu verdrängen einander in jeder Liste und machen aus der Rubrik einen Katalog.

Die Zuordnung

Eine Zeile je Feld: links unser Feld, rechts eure Spalte. Ein Punkt geht eine Ebene tiefer, ein Stern sammelt über eine Liste.

external_id  = ObjektNr
title        = Objektname
excerpt      = Kurztext
description  = Beschreibung
postal_code  = Adresse.PLZ
city         = Adresse.Ort
state        = Bundesland
age_from     = fest:0
age_to       = fest:18
price_from   = kleinster:Preise.*.ab
price_info   = text:Preise.*.hinweis
country      = land:Land
is_indoor    = haken:Innenbereich

Umrechnung	Was sie tut
`fest:`	Derselbe Wert für jede Zeile. Für alles, was euer Export nicht hat.
`kleinster:`	Der kleinste Wert aus einer Liste, etwa der Ab-Preis über alle Saisons.
`groesster:`	Der größte Wert aus einer Liste.
`land:`	Aus „Frankreich" wird FR. Was wir nicht kennen, lässt die Zeile durchfallen.
`haken:`	Aus ja, 1, true, wahr wird ein Haken, aus allem anderen keiner.
`text:`	Eine Liste wird ein Text, eine Zeile je Eintrag.

Was ein Lauf nicht kann

Die drei Riegel gibt es, weil ein abgebrochener Export der häufigste Fall ist, in dem ein Bestand verschwindet.

1
Eine halbe Datei wird nicht geglaubt. Bringt ein Lauf weniger als die Hälfte der Zeilen des letzten, wird er gar nicht erst verarbeitet.
2
Was fehlt, wird pausiert und nicht gelöscht, und erst, wenn es zweimal hintereinander gefehlt hat. Kommt es zurück, ist es wieder da.
3
Gelöscht wird nur auf ausdrückliche Ansage, und dann in den Papierkorb.

Was	Wie viel
Größe der Datei	50 MB
Zeit für den Abruf	30 Sekunden
Umleitungen	3
Zeilen je Minute	50
Mindestanteil gegenüber dem letzten Lauf	50 Prozent

Der Probelauf

In eurem Konto unter „Feed" steht ein Knopf, der eure Datei holt und für die ersten zehn Zeilen zeigt, was daraus würde und was durchfällt. Gespeichert wird dabei nichts.

Zum Probelauf

Stand der Beschreibung: 2026-10-31