https://github.com/costastf/ovchipcardlib
A library to interact with ov-chip cards on line api.
https://github.com/costastf/ovchipcardlib
gvb ns ov-chip ov-chipkaart
Last synced: 12 months ago
JSON representation
A library to interact with ov-chip cards on line api.
- Host: GitHub
- URL: https://github.com/costastf/ovchipcardlib
- Owner: costastf
- License: mit
- Created: 2017-05-09T11:27:55.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2022-12-09T05:29:41.000Z (over 3 years ago)
- Last Synced: 2025-04-17T12:41:18.313Z (about 1 year ago)
- Topics: gvb, ns, ov-chip, ov-chipkaart
- Language: Python
- Size: 945 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
=============
ovchipcardlib
=============
A library to interact with the ov-chip card service.
It utilizes the webapi of the mobile apps to get the information.
Very loosely based on https://github.com/OVChip/ovchipapi-python for the
authentication part.
Be aware that the ov-chip card system used in the Netherlands for public
transport was not designed to be real time. So expect a hefty time drift
before the actual checkin/out action and information showing up on the api
and by extension on the transactions list.
Also the sequence of transactions is not guaranteed. It is absolutelly
certain that if there are a lot of checkins/outs closely together they will
appear out of order on the web api. Apparently there is a serverside job that
sorts them once a day.
The library handles that by sorting the list of transactions always. So on
any action it would return a properly ordered list of events but in case of
monitoring through the card.get_latest_transactions() method it is
absolutelly guaranteed that transaction will appear out of order and with a
delay ranging between 2 and 15 minutes according to some simple benchmarks.
* Documentation: http://ovchipcardlib.readthedocs.io/en/latest/
Features
--------
* Can get cards bound with the account and lists of transactions for the cards.