Deze webservice (v1) doorzoekt (hoofdletterongevoelig) het Wie (onder)zoekt wie? register en retourneert
het aantal voorkomens van de geslachtsnaam. Het resultaat kan gebruikt worden als indicatie voor het bekend zijn van stamboomonderzoekers
die de geslachtsnaam (onder)zoeken.
Request
URL
https://api.coret.org/wiezoektwie/aantal/v1/
Parameters
Parameter |
Type |
Beschrijving |
q |
string (verplicht) |
De familienaam die (hoofdletterongevoelig) opgezocht moet worden in het Wie (onder)zoekt wie? register. Minimale lengte is 2 karakters. Voorvoegsels dienen achter de geslachtsnaam geplaatst te worden, voorbeeld: "Buuren, van". |
output |
string (optioneel) |
Formaat van de uitvoer (altijd UTF-8):
- xml - voor XML (standaard)
- json - voor JSON
- php - voor geserialiseerd PHP
|
search |
string (optioneel) |
Hoe te zoeken:- exact - naam moet exact overeenkomen met zoekterm q
- start - naam moet beginnen met zoekterm q (standaard)
- bevat - naam moet zoekterm q bevatten
|
Uitproberen
Response
Elementen
- Aantal - Aantal stamboomonderzoekers die een familienaam onderzoeken die voldoet aan de zoekterm q.
- Zoeken - URL die gebruikt kan worden om de resultaten te reproduceren door gebruik in browser. De URL dient aangevuld te worden door de zoekterm q.
Voorbeeld XML uitvoerformaat (zoeken naar familienamen die starten met 'cor')
8
https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=
Voorbeeld JSON uitvoerformaat (zoeken naar familienamen die starten met 'cor')
{
"Coret":{
"WieZoektWie":{
"Aantal":"8","Url":{
"Zoeken":"https:\/\/www.stamboomforum.nl\/wiezoektwie/zoeken.php?gw=ap&q="
}
}
}
}
Serialized PHP uitvoerformaat (zoeken naar familienamen die starten met 'cor')
a:1:{
s:5:"Coret";a:1:{
s:11:"WieZoektWie";a:2:{
s:6:"Aantal";s:1:"8";s:3:"Url";a:1:{
s:6:"Zoeken";s:46:"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=";
}
}
}
}
Gebruik
Er kan gratis gebruik gemaakt worden van deze API.
Het wordt op prijs gesteld als er een link opgenomen wordt naar https://www.stamboomforum.nl/wiezoektwie/ en/of één van de logo's zichtbaar gemaakt wordt: