vaccipy

vaccipy hilft dabei, einen Impftermin beim Impfterminservice zu buchen.

Ausgangssituation

Unsere Großeltern möchten sich gerne impfen lassen, aber telefonsich unter 116117 kommen sie nicht durch und das Internet ist auch noch immer irgendwie Neuland. Jetzt kommt es zum Konflikt: einerseits möchte man natürlich gerne bei der Terminbuchung helfen, andererseits hat man aber auch keine Lust, deshalb nun den ganzen Tag vor dem Computer zu hocken und die Seite zu aktualisieren...

Requirements

• Python 3 (getestet mit Python 3.9)
• pip (zur Installation der Python-Module, getestet mit pip3)

Die notwendigen Python-Module können mittels pip installiert werden.

pip3 install requirements.txt

vaccipy kann über die Kommandozeile oder in einer beliebigen python-Entwicklungsumgebung ausgeführt werden:

python3 main.py

Wie funktioniert vaccipy?

Zunächst trägst du deinen "Impf-Code" (Beispiel: A1B2-C3D4-E5F6), die PLZ deines Impfzentrums und deine Daten (Anschrift, Telefon, Mail) ein, die bei der Terminbuchung angegeben werden sollen. Du wirst zur Eingabe aufgefordert und deine Daten werden in der Datei ./kontaktdaten.json gespeichert.

Hinweis: Es kann sein, dass für mehrere Impfzentren unterschiedliche Codes benötigt werden.

Anschließend passiert alles automatisch: vaccipy checkt für dich minütlich, ob ein Termin verfügbar ist und bucht den erstbesten.

Workflow

vaccipy nutzt die selben Endpunkte zur Terminbuchung, wie dein Browser.

1. Abruf aller Impfzentren und abgleich, ob für die eingetragene PLZ ein Impfzentrum existiert
2. Abruf der Impfstoffe, die im gewählten Impfzentrum verfügbar sind

Zur Terminbuchung werden Cookies benötigt (bm_sz), die im Browser automatisch erzeugt werden. Damit wir diese auch im Script haben, wird zu Beginn eine Chrome-Instanz (im Prinzip ein separates Chrome-Fenster) geöffnet und eine Unterseite des Impfterminservices aufgerufen. Anschließend werden die Cookies extrahiert und im Script aufgenommen.

3. Cookies abrufen
4. Mit dem Code "einloggen", im Browser ist das der Schritt: Impfzentrum auswählen und den Code eintragen

Die nachkommenden Schritte erfolgen im Loop. Es werden minütlich verfügbare Termine abgerufen und, sollte ein Termin verfügbar sein, der erstbeste ausgewählt. Dieser Prozess kann eine längere Zeit dauern und die Cookies laufen irgendwann ab (entweder alle 10 Minuten oder nach 5-6 Anfragen). Sobald die Cookies abgelaufen sind, wird wieder ein Chrome-Fenster geöffnet und neue Cookies erstellt.

5. Termine abrufen: Wenn Termine verfügbar sind, springe zu Schritt 8

6. Eine Minute warten oder

7. (bei Ablauf) Cookies erneuern

Wenn ein Termin verfügbar ist, wird dieser mit den eingetragenen Daten gebucht.

Achtung! Im nächsten Schritt wird ein verbindlicher Impftermin gebucht!

8. Buchen des Impftermins

Termin gebucht, was nun?

Nachdem dein Termin erfolgreich gebucht wurde, erhälst du eine Mail, in der du zunächst deine Mail-Adresse bestätigen musst. Nachdem du die Mail bestätigt hast, erhälst du zu jedem Termin eine Buchungsbestätigung. That's it!

Das könnte noch kommen

Es gibt noch ein paar Features, die cool wären. Die Ideen werden hier mal gesammelt und werden (von uns oder euch - feel free!) irgendwann hinzukommen:

• Datum eingrenzen bei der Terminwahl
• ...

Das kann vaccipy NICHT - und wird es auch nie können

vaccipy dient lediglich als Unterstützung bei der Impftermin-Buchung EINER EINZELNEN PERSON, weshalb folgende Automatisierungen und Erweiterungen NICHT kommen werden:

• Erstellung des Impf-Codes
• Filterung der verfügbaren Termine nach Impfstoff
• Möglichkeit zum Eintragen mehrerer Impf-Codes und Kontaktdaten
• Headless Selenium Support
• ... ein paar andere Sachen, wir wollen ja keine schlafenden Hunde wecken ;-)

Seid vernünftig und missbraucht das Tool nicht.

save da world. my final message. goodbye.