Neues Release: 2 neue Suchfilter, Ergebnisliste-Eintrag enthält Veröffentlichungsdatum
von Sascha Boerger
Wir haben einige weitere Featurewünsche in der Search-API umgesetzt, die heute live gegangen sind:
1.
Speziell für mobile Clients haben wir den Featurewunsch “ich möchte wissen, welche Objekte seit Datum X (z.B. seit der letzte lokal gespeicherte Suche) veröffentlicht wurden um diese in der Ergebnisliste entsprechend als “NEU” zu kennzeichnen” umgesetzt.
Dazu wurde für die region search und die radius search ein neuer Suchparameter eingeführt: publishedafter. Das Suchergebnis wird dabei nicht gefiltert, sondern die Objekte bekommen ein weiteres Attribut.
Request:
http://rest.immobilienscout24.de/restapi/api/search/v1.0/search/region?realestatetype=apartmentrent&geocodes=1276&publishedafter=2012-06-01T00:00:00
Response:
Die Ergebnisliste-Einträge enthalten sowohl ein Booleanwert als auch das publishDate des Objektes, wenn der Suchparameter “publishedafter” angegeben wurde
<entry>
<publishDate>05.06.2012<publishDate>
<publishedAfter date=”01.06.2012"> true <publishedAfter>
….
<entry>
2.
Du möchtest nur die Objekte bekommen, die seit Tag X veröffentlicht wurden? z.B. um in einer Übersicht mit letzten — und gespeicherten- Suchen anzeigen zu können, wie viele Objekte neu hinzugekommen sind? Dazu haben wir den Suchparameter “firstactivation” eingeführt, der nur die Objekte liefert, die nach Tag X veröffentlicht wurden.
Request:
http://rest.immobilienscout24.de/restapi/api/search/v1.0/search/region?realestatetype=apartmentrent&geocodes=1276&firstactivation=2012-06-01T00:00:00
Doku zu 1) und 2): http://developer.immobilienscout24.de/wiki/Search/GET/QueryParameters#For_both_Radius_and_Region_Search
3.
Veröffentlichungsdatum “publishDate” in Ergebnisliste-Einträge mitausgeben. Denn das Creationdate sagt nur aus, wann ein Objekt in der ImmobilienScout24-Datenbank angelegt wurde, nicht wann es veröffentlicht wurde. Das Creationdate wird aus Kompabilitätsgründen beibehalten
- <resultlistEntry publishDate=”2012–06–29T12:05:16.000+02:00" creation=”2012–06–29T12:05:03.000+02:00" modification=”2012–07–01T20:54:35.000+02:00" id=”61971321" xlink:href=”http://rest.immobilienscout24.de/restapi/api/search/v1.0/expose/61971321">