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/onderzoekers/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
- jswrite - voor uitvoer van Javascript via document.write's
|
| 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
|
| target |
string (optioneel, alleen bij jswrite) |
De target die wordt ingevoegd bij alle links. Default leeg, dus alle links openen in zelfde window. |
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 Javascript uitvoerformaat (zoeken naar familienamen die starten met 'cor')
<![CDATA[
document.write("<div id=\"wiezoektwie\">");
document.write("<p><img src=\"https://static.coret.org/img/icon/sf.gif\"/> <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=\">Wie (onder)zoekt wie?</a> resultaten</p>");
document.write("<ul>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/15\">Bob Coret</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Coret\">Coret</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/425\">Monica Boon</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Cornelis\">Cornelis</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/251\">henkc</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Corba\">Corba</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/1726\">W.Berentsen</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Cornelissen\">Cornelissen</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/1031\">Peeters</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Cornellii\">Cornellii</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/1887\">hennie-smits</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Corstiaans\">Corstiaans</a></li>");
document.write("<li><a href=\"https://www.stamboomforum.nl/profiel/2046\">Rik Cornelius</a> (onder)zoekt de naam <a href=\"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=Cornelius\">Cornelius</a></li>");
document.write("</ul>");
document.write("</div>");
]]>
Door <script src="https://api.coret.org/wiezoektwie/onderzoekers/v1/?q=cor&output=jswrite" type="text/javascript"></script> op
te nemen in een webpagina ziet u onderstaande uitvoer. De opmaak kan zelf ingesteld worden, onderstaande is met de voorbeeld CSS opgemaakt.
Voorbeeld XML uitvoerformaat (zoeken naar familienamen die starten met 'cor')
<![CDATA[
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Coret>
<WieZoektWie>
<Aantal>7</Aantal>
<Url>
<Zoeken>https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=</Zoeken>
<Profiel>https://www.stamboomforum.nl/profiel/</Profiel>
</Url>
<Resultaten>
<Resultaat>
<Naam>Corba</Naam>
<Onderzoeker>henkc</Onderzoeker>
<ProfielID>251</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Coret</Naam>
<Onderzoeker>Bob Coret</Onderzoeker>
<ProfielID>15</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Cornelis</Naam>
<Onderzoeker>Monica Boon</Onderzoeker>
<ProfielID>425</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Cornelissen</Naam>
<Onderzoeker>W.Berentsen</Onderzoeker>
<ProfielID>1726</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Cornelius</Naam>
<Onderzoeker>Rik Cornelius</Onderzoeker>
<ProfielID>2046</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Cornellii</Naam>
<Onderzoeker>Peeters</Onderzoeker>
<ProfielID>1031</ProfielID>
</Resultaat>
<Resultaat>
<Naam>Corstiaans</Naam>
<Onderzoeker>hennie-smits</Onderzoeker>
<ProfielID>1887</ProfielID>
</Resultaat>
</Resultaten>
</WieZoektWie>
</Coret>
]]>
Voorbeeld JSON uitvoerformaat (zoeken naar familienamen die starten met 'cor')
<![CDATA[
{
"Coret":{
"WieZoektWie":{
"Aantal":7,"Url":{
"Zoeken":"https:\/\/www.stamboomforum.nl\/wiezoektwie/zoeken.php?gw=ap&q=",
"Profiel":"https:\/\/www.stamboomforum.nl\/profiel\/"
},"Resultaten":{
"Resultaat":[
{"Naam":"Corba","Onderzoeker":"henkc","ProfielID":"251"},
{"Naam":"Coret","Onderzoeker":"Bob Coret","ProfielID":"15"},
{"Naam":"Cornelis","Onderzoeker":"Monica Boon","ProfielID":"425"},
{"Naam":"Cornelissen","Onderzoeker":"W.Berentsen","ProfielID":"1726"},
{"Naam":"Cornelius","Onderzoeker":"Rik Cornelius","ProfielID":"2046"},
{"Naam":"Cornellii","Onderzoeker":"Peeters","ProfielID":"1031"},
{"Naam":"Corstiaans","Onderzoeker":"hennie-smits","ProfielID":"1887"}]
}
}
}
}
]]>
Serialized PHP uitvoerformaat (zoeken naar familienamen die starten met 'cor')
<![CDATA[
a:1:{
s:5:"Coret";a:1:{
s:11:"WieZoektWie";a:3:{
s:6:"Aantal";i:7;s:3:"Url";a:2:{
s:6:"Zoeken";s:52:"https://www.stamboomforum.nl/wiezoektwie/zoeken.php?gw=ap&q=";
s:7:"Profiel";s:36:"https://www.stamboomforum.nl/profiel/";
}
s:10:"Resultaten";a:1:{
s:9:"Resultaat";a:7:{
i:0;a:3:{
s:4:"Naam";s:5:"Corba";s:11:"Onderzoeker";s:5:"henkc";
s:9:"ProfielID";s:3:"251";
}
i:1;a:3:{
s:4:"Naam";s:5:"Coret";s:11:"Onderzoeker";s:9:"Bob Coret";
s:9:"ProfielID";s:2:"15";
}
i:2;a:3:{
s:4:"Naam";s:8:"Cornelis";s:11:"Onderzoeker";s:11:"Monica Boon";
s:9:"ProfielID";s:3:"425";
}
i:3;a:3:{
s:4:"Naam";s:11:"Cornelissen";s:11:"Onderzoeker";s:11:"W.Berentsen";
s:9:"ProfielID";s:4:"1726";
}
i:4;a:3:{
s:4:"Naam";s:9:"Cornelius";s:11:"Onderzoeker";s:13:"Rik Cornelius";
s:9:"ProfielID";s:4:"2046";
}
i:5;a:3:{
s:4:"Naam";s:9:"Cornellii";s:11:"Onderzoeker";s:7:"Peeters";
s:9:"ProfielID";s:4:"1031";
}
i:6;a:3:{
s:4:"Naam";s:10:"Corstiaans";s:11:"Onderzoeker";s:12:"hennie-smits";
s:9:"ProfielID";s:4:"1887";
}
}
}
}
}
}
]]>
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:
Wie (onder)zoekt wie? resultaten