Deze webservice (v1) doorzoekt (hoofdletterongevoelig) het Wie (onder)zoekt wie? register en retourneert
de namen die overeenkomen. Het resultaat kan gebruikt worden om een lijst te tonen van familienamen waarvan bekend
is dat deze (onder)zocht worden door stamboomonderzoekers.
Request
URL
https://api.coret.org/wiezoektwie/namen/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')
1
https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=
Coret
Voorbeeld JSON uitvoerformaat (zoeken naar familienamen die starten met 'cor')
{
"Coret":{
"WieZoektWie":{
"Aantal":1,"Url":{
"Zoeken":"https:\/\/www.stamboomforum.nl\/wiezoektwie/zoeken.php?gw=ap&q="
},"Resultaten":{
"Resultaat":[{"Naam":"Coret"}]
}
}
}
}
Serialized PHP uitvoerformaat (zoeken naar familienamen die starten met 'cor')
a:1:{
s:5:"Coret";a:1:{
s:11:"WieZoektWie";a:3:{
s:6:"Aantal";i:1;s:3:"Url";a:1:{
s:6:"Zoeken";s:52:"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=";
}
s:10:"Resultaten";a:1:{
s:9:"Resultaat";a:1:{
i:0;a:1:{
s:4:"Naam";s:5:"Coret";
}
}
}
}
}
}
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: