# | Tag | Aantal posts |
---|---|---|
Laden... | ||
Er is een API in ontwikkeling om te dienen als verbeterde zoekfunctie van Dumpert. Hieronder staat een korte uitleg over hoe het zoeken werkt:
De zoekfunctie is te bereiken op https://api.dev.vindert.nl/search. Er moet een query parameter ?q=
meegegeven worden met een zoekterm die minimaal 3 tekens lang is. Opties die worden meegegeven in de zoekterm tellen niet mee voor deze lengte.
De API heeft de volgende opties om zoeken makkelijker te maken:
Om op NSFW te filteren is het mogelijk om de query parameter nsfw
te gebruiken, of in de zoekterm de tekst nsfw:<waarde>
te zetten. Standaard staan er zowel NSFW als niet-NSFW posts in de resultaten. De mogelijke waarden zijn:
true
false
yes
no
ja
nee
Om op post type te filteren is het mogelijk om de query parameter type
te gebruiken, of in de zoekterm de tekst type:<waarde>[,<waarde2>]
te zetten. Standaard staan alle type posts in de resultaten. Om meerdere types tegelijk te zoeken, zet je een komma tussen de waarden. type:video,audio
geeft dus alleen posts die bestaan uit minstens 1 video of minstens 1 audio-fragment. De mogelijke waarden zijn:
video
image
audio
foto
(zelfde als image
)plaatje
(zelfde als image
)Om op datum te filteren is het mogelijk om de query parameters before
en/of after
te gebruiken, of in de zoekterm de tekst before:<waarde>
, after:<waarde>
, voor:<waarde>
en na:<waarde>
te zetten. Standaard worden posts van alle datums getoond. De mogelijke waarden zijn:
2018
(een jaartal)10-2018
(een maand en jaartal)31-10-2018
(een dag, maand en jaartal)Om te kunnen sorteren is het mogelijk om de query parameter sort
te gebruiken, of in de zoekterm de tekst sort:<waarde>
of sorteren:<waarde>
te zetten. Standaard worden de resultaten gesorteerd op de datum waarop de post is geplaatst, met de nieuwste video als eerst. Door achter de waarden hier onder een <
of >
te zetten, kan de volgorde veranderd worden. sort:views>
geeft de post met het minst aantal views eerst, en sorteert de rest oplopend. De mogelijke waarden zijn:
score
(de score die de database aan de zoekterm geeft)date
(de datum van de plaatsing van de post)kudos
(het huidige aantal kudos)views
(het huidige aantal views)comments
(het huidige aantal reaguursels)datum
(zelfde als date
)reaguursels
(zelfde als comments
)Een zoekresultaat geeft maximaal 30 posts. Om meer posts op te halen, is het mogelijk om de query parameter page
te gebruiken. Pagina 0 is de eerste pagina, en het aantal mogelijke pagina's is te vinden in de API-response.