Zum Hauptinhalt springen

Filterung

Viele Endpoints der mail2many API unterstützen Filterung. Dazu wird der Query‑Parameter search verwendet. Der Parameter muss als URL‑kodiertes JSON übermittelt werden.

Filterlogik​

  • Ohne Bedingung: Wird = angenommen (exakte Übereinstimmung)
  • Mehrere Filter: Werden mit AND verknüpft
  • Mehrere Werte im Filter: Werden mit OR verknüpft

Einfache Filter​

Um nach einem einzelnen Wert zu filtern:

search=[{"languageIso":"de"}]

Filter mit mehreren Werten​

Um nach mehreren Werten zu filtern (OR):

search=[{"genderId":[1,2]}]

Filter mit Bedingungen​

Für erweiterte Suche verwendest du eine Bedingung:

search=[{"email":{"condition":"like","value":"%example.com%"}}]

Verfügbare Bedingungen​

BedingungBeschreibung
=Exakte Übereinstimmung (Standard)
likeSQL LIKE‑Operator für Teilzeichenkettensuche
>Größer als
>=Größer gleich
<Kleiner als
<=Kleiner gleich

Mehrere Filter kombinieren​

Filter werden mit AND kombiniert:

search=[{"languageIso":"de"},{"genderId":1}]

Das filtert nach Objekten mit languageIso = "de" UND genderId = 1.