Dit document is overgenomen van EUR-Lex
Webservice
Met onze webservice kunnen geregistreerde gebruikers rechtstreeks in EUR-Lex zoeken zonder gebruik te maken van het zoekformulier op de website.
De zoekmogelijkheden zijn daarbij ongeveer hetzelfde als voor geavanceerd (booleaans) zoeken en de resultaten worden in XML-formaat aangeleverd. Elke zoekopdracht op de website, inclusief fulltext-zoeken, kan ook via de webservice worden uitgevoerd. Deze webservice is gebaseerd op het SOAP-protocol en is na registratie gratis te gebruiken.
Met de webservice kunt u weliswaar zoeken in de tekst van de documenten, maar u kunt de documentbestanden er niet rechtstreeks mee downloaden.
Downloaden van documenten op basis van hun identificatiecode kan op twee manieren: via de RESTful-API van Cellar, of door een URL aan te maken zoals wordt beschreven in onze richtsnoeren voor stabiele links.
Wilt u nog eenvoudiger op de hoogte blijven, dan kunt u gebruikmaken van voorgedefinieerde of op maat gemaakte RSS-feeds.
Registratie
Zo registreert u zich voor het gebruik van onze webservices:
- Klik op Registreren voor webservices.
- Klik op Registreren als u nog geen EU Login-account hebt.
- Hebt u al een account, klik dan op Aanmelden. Lees meer over hoe u zich kunt aanmelden bij EUR-Lex.
- Klik op Registreren en vul het registratieformulier in (zie de tabel hieronder).
- Klik op Opslaan om het formulier in te dienen.
- Na controle laten wij u in een e-mail weten wat uw toegangsrechten zijn.
In te vullen informatie
| Gewenste data | De gegevens die u met het oog op uw toepassing met de webservice wilt verzamelen |
| Uiteindelijke toepassing | Het doel waarvoor u de gegevens uiteindelijk wilt gebruiken |
| Maximumaantal aanroepen per dag | Het maximale aantal keer per dag dat u de webservice zult aanroepen |
| Commentaar | Aanvullende informatie |
| Gebruikersnaam | Uw gebruikersnaam (deze is al ingevuld en kan niet door u worden veranderd) |
| Achternaam | Uw achternaam |
| Voornaam | Uw voornaam |
| Uw e-mailadres | |
| Naam | De naam van uw organisatie |
| Land | Het land waar uw organisatie gevestigd is |
| Ik ga akkoord met de gebruiksvoorwaarden van EUR-Lex zoals vastgelegd in de Juridische mededeling | Een verklaring dat u instemt met de voorwaarden waaronder u van de webservice gebruik mag maken |
Aanwijzingen voor het gebruik van de webservice
U kunt de webservice gebruiken zodra u een e-mail met de toegangsgegevens heeft ontvangen:
- Klik op Registreren voor webservices.
- U krijgt dan een link naar de WSDL-specificatie voor de webservice. Om zoekopdrachten naar EUR-Lex te sturen, moet uw applicatie een URL sturen die aan de WSDL-specificatie beantwoordt.
- Bij het aanroepen van de webservice moet u de gebruikersnaam en het wachtwoord gebruiken die we u hebben toegestuurd. U moet
de volgende parameters meegeven:
- uw zoekopdracht in het formaat van een geavanceerde (booleaanse) zoekopdracht. Met SELECT kunt de metadata kiezen en met ORDER BY de sorteervolgorde. U kunt ook gebruikmaken van het webservicesjabloon.
- de taal
- het paginanummer
- het aantal resultaten per pagina
- De lijst van resultaten bevat, voor elk document, de door u gekozen metadata. Als u geen metadata kiest, wordt het bij uw zoekvoorkeuren ingestelde weergaveprofiel gebruikt.
Webservicesjabloon downloaden
Als u toegang hebt gekregen tot de webservice, kunt u een speciaal XML-sjabloon downloaden dat u voor al uw zoekopdrachten kunt gebruiken:
- Meld u aan en voer een zoekopdracht uit (snelzoeken, uitgebreid zoeken of geavanceerd (booleaans) zoeken).
- Klik op het sjabloonpictogram bovenaan de pagina met zoekresultaten.
- Er verschijnt een venster met een gestructureerde zoekopdracht en met instructies over hoe u deze in uw aanroep van de webservice kunt gebruiken.
U kunt dit sjabloon kopiëren en voor alle volgende webservice-aanroepen gebruiken.
Uw webservicelimieten aanpassen
U kunt de webservice elke dag maar een beperkt aantal keren gebruiken. U kunt deze limiet via de webservicepagina laten aanpassen.
Wij zullen u per e-mail laten weten wat uw (eventuele) nieuwe limiet is.
Uitschrijven
Als u niet langer gebruik wenst te maken van de webservices, moet u zich op de webservices-pagina uitschrijven.
Vermeld waarom u zich uitschrijft en klik daarna op Uitschrijven.
Uw toegang tot de webservice wordt dan ingetrokken en uw wachtwoord wordt gedeactiveerd.
Aanvullende informatie over webservices (alleen in het Engels)
Hebt u vragen, neem dan gerust contact op met EURLEX-HELPDESK@publications.europa.eu