b426be57ab
* Aanpassingen dd-oper-api ddOperApi * Aanpassingen dd-api-oper ddOperApi * __version__ toegevoegd inclusief githook
79 lines
2.2 KiB
Markdown
79 lines
2.2 KiB
Markdown
# dd-api-oper
|
|
## Inleiding
|
|
|
|
Rijkswaterstaat maakt gebruik van de [Operationele Digitale Delta API]
|
|
(https://digitaledeltaorg.github.io/dd-oper.v201.html). Deze api word
|
|
gebruikt voor het opvragen van:
|
|
|
|
* Metingen
|
|
* Verwachtingen
|
|
* Astronomisch getij
|
|
|
|
De digitale delta api is beschikbaar via:
|
|
|
|
* https://ddapi.rws.nl/dd-oper/2.0
|
|
|
|
De authenticatie op deze url is geregeld via PKI overheidscertificaten.
|
|
Zonder PKI overheidscertificaat is de api niet toegankelijk.
|
|
|
|
Deze git repository bevat een python module om de dd-api te benaderen
|
|
inclusief:
|
|
|
|
* Autenticatie via certificaten.
|
|
* Access functies voor de resultaten.
|
|
|
|
## De inhoud van de git repository
|
|
|
|
TODO: Aanpassen aan module
|
|
|
|
* ddapioper.py: Python module
|
|
* test-ddapi: Een klein voorbeeld en test programma voor de module
|
|
* DD-API-Oper demo.ipynb: Een [Jupyter notebook](met een demo).
|
|
|
|
### ddapioper.py
|
|
|
|
Deze module bevat documentatie. Deze is op te vragen door de module te
|
|
laden en vervolgens via de python hulp functie heb je toegang tot de
|
|
documentatie.
|
|
|
|
### test-ddapi
|
|
|
|
Een werkend voorbeeld en test programma voor de api.
|
|
|
|
Wel moeten de paden van het certificaat en de bijbehorende private key
|
|
nog ingevuld worden. Er staat twee keer "<TODO>" in de code.
|
|
|
|
### DD-API-Oper demo.ipynb
|
|
|
|
Een werende demo in Jupyter van de dd-api en de module.
|
|
|
|
In deze demo worden de volgende elementen getoont:
|
|
|
|
* Het opvragen van de lijst met locaties.
|
|
* De gegevens van een locatie.
|
|
* Het opvragen van de quantities.
|
|
* Inclusief de quantities van een specefieke locatie.
|
|
* Het opvragen van waarde.
|
|
* Het opvragen diverse meta data gegevens.
|
|
* Het verder verwerken van meetgegevens.
|
|
* De meetgegevens in rmi sip formaat weergeven.
|
|
* Het plotten van meetgegevens in een grafiek
|
|
|
|
## Over de certificaten.
|
|
|
|
Om de api te kunnen gebruiken is een pki overheidscertificaat en de
|
|
bijbehorende private key nodig. Het certicaat moet geldig zijn als
|
|
client certificaat.
|
|
|
|
Het certificaat moet aangeboden worden in x509 formaat en de private
|
|
key mag niet encrypt zijn.
|
|
|
|
## Status
|
|
|
|
Deze module en de voorbeeld code is in ontwikkeling. Dit is geen
|
|
stabiele code!
|
|
|
|
## Vragen en/of uitbreidingen.
|
|
|
|
Vragen en of uitbreidingen kunnen gemaild worden naar ddoperapi@pion.xs4all.nl.
|