Um das Nutzungserlebnis für die Benutzer unserer Core-API zu verbessern, haben wir Nummerierungs- und Filtermechanismen eingeführt, die den Zugriff auf große Datensätze einfacher und effizienter machen.
Seitennummerierung
Bei der Anforderung großer Datenmengen werden die Seiten durchnummeriert, um einen schnellen, übersichtlichen Datenabruf zu gewährleisten. Um alle Seiten nacheinander abzurufen, nutzen Sie den Parameter „Anzahl“ gemäß der Eigenschaft „totalPages“. Über den Größenparameter (max. 200) können Sie die Anzahl der Ergebnisse pro Seite festlegen. Ohne Angabe ist der Standardwert 25.
Filterparameter
Die Core-API von Measurabl nutzt logische Operatoren und Vergleichsoperatoren in RSQL, um die parametrisierte Filterung von Einträgen für die meisten verfügbaren Endpunkte zu unterstützen. Das ermöglicht Benutzern den Abruf von Daten auf Grundlage bestimmter Bedingungen, sodass sie konkretere, effizientere Anfragen stellen können.
Vergleichsoperatoren
| Operator | Bedeutung | Beschreibung | Beispiel |
| == | Gleich | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte genau dem Abfragewert entsprechen. |
?filter=name=='Hauptstraße 10' ?filter=name=='Haupt* 10' ?filter=name=='haupt* 10' |
| =like= | Wie | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte bei einer Platzhaltersuche dem Abfragewert ähneln. | ?filter=addressLine1=like='Hauptstraße' |
| =in= | In | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte einem der in der Abfrage angegebenen Werte entsprechen (WertA ODER WertB). |
?filter=percentOwned=in='20, 50' ?filter=primaryPropertyType=in=('Finanzbüro', 'Rechenzentrum') |
| =out= | Nicht in | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte keinem der in der Abfrage angegebenen Werte entsprechen (weder WertA noch WertB). | ?filter=addressCountry=out=('USA', 'Deutschland') |
| != | Nicht gleich | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte nicht dem Abfragewert entsprechen. | ?filter=percentOwned!='100' |
| =notlike= | Nicht wie | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte bei einer Platzhaltersuche dem Abfragewert nicht ähneln. | ?filter=addressCountry=notlike='Großbritannien' |
| < oder =lt= | Kleiner als | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte kleiner als der Abfragewert sind. |
?filter=floorAreaSqFt=lt=50000 ?filter=floorAreaSqFt<50000 |
| <= oder =le= | Kleiner oder gleich | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte dem Abfragewert entsprechen oder kleiner sind. |
?filter=floorAreaSqFt=le=50000 ?filter=floorAreaSqFt<=50000 |
| oder =gt= | Größer als | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte größer als der Abfragewert sind. | ?filter=floorAreaSqFt=gt=50000 ?filter=floorAreaSqFt50000 |
| = oder =ge= | Größer oder gleich | Gibt Zeilen zurück, bei denen die Werte in der angegebenen Spalte dem Abfragewert entsprechen oder größer sind. | ?filter=floorAreaSqFt=ge=50000 ?filter=floorAreaSqFt=50000 |
Logische Operatoren
| Operator | Bedeutung | Beschreibung | Beispiel |
| ; oder and | Logisches UND | Kombiniert mehrere Bedingungen. Die zurückgegebenen Zeilen erfüllen alle angegebenen Bedingungen gleichzeitig. |
?filter=addressState=='CA' and floorAreaSqFt<='100000' and yearBuilt='1950' ?filter=addressState=='CA';floorAreaSqFt<='100000';yearBuilt='1950' |
| , oder or | Logisches ODER | Kombiniert mehrere Bedingungen. Die zurückgegebenen Zeilen erfüllen mindestens eine der angegebenen Bedingungen. |
?filter=addressState==CA or (addressZip=in=(10001,10017,10177) and addressState==NY) ?filter=addressState==CA,(addressZip=in=(10001,10017,10177);addressState==NY) |
Mithilfe dieser Nummerierungs- und Filterfunktionen können Core-API-Nutzer unkompliziert auf benötigte Daten zugreifen und sich besser orientieren. Das sorgt für ein optimiertes, effizienteres Nutzungserlebnis.