How fryyyyy/zeekr_ev_api works
zeekr_ev_api is a Python client for Zeekr EV services. A caller configures a ZeekrClient with account credentials and required signing/encryption secrets, then uses it to authenticate and request vehicle data or actions. The client handles authentication and domain operations; network helpers send HMAC- or app-signed requests, while separate modules implement each signing scheme. README and sampled source establish this structure; some vehicle capabilities are identified by endpoint constants but their individual call paths were not sampled.
Main entry points: client.py Zeekr client · network.py HTTP request helpers · exceptions.py API exceptions · zeekr_app_sig.py App signatures
Components 13
Client API
- Zeekr client
src/zeekr_ev_api/client.py - Authentication and session
src/zeekr_ev_api/client.py - Vehicle status
src/zeekr_ev_api/client.py - Remote control
src/zeekr_ev_api/client.py - Charging plans
src/zeekr_ev_api/client.py - Trips and journeys
src/zeekr_ev_api/client.py
Request and Signing
- HTTP request helpers
src/zeekr_ev_api/network.py - App signatures
src/zeekr_ev_api/zeekr_app_sig.py - HMAC signatures
src/zeekr_ev_api/zeekr_hmac.py
Configuration and Errors
- Endpoints and defaults
src/zeekr_ev_api/const.py - API exceptions
src/zeekr_ev_api/exceptions.py
Other components
- Library caller
- Zeekr API services
Connections 15
- Library caller → Zeekr client: uses
README.md - Zeekr client → Authentication and session: exposes
src/zeekr_ev_api/client.py - Zeekr client → Vehicle status: exposes
src/zeekr_ev_api/client.py - Zeekr client → Remote control: exposes
src/zeekr_ev_api/client.py - Zeekr client → Charging plans: exposes
src/zeekr_ev_api/client.py - Zeekr client → Trips and journeys: exposes
src/zeekr_ev_api/client.py - Authentication and session → HTTP request helpers: sends requests
src/zeekr_ev_api/client.py - Vehicle status → HTTP request helpers: requests status
src/zeekr_ev_api/client.py - Charging plans → HTTP request helpers: requests plans
src/zeekr_ev_api/client.py - HTTP request helpers → HMAC signatures: signs HMAC
src/zeekr_ev_api/network.py - HTTP request helpers → App signatures: signs requests
src/zeekr_ev_api/network.py - HTTP request helpers → Zeekr API services: sends HTTP
src/zeekr_ev_api/network.py - Zeekr client → Endpoints and defaults: uses endpoints
src/zeekr_ev_api/client.py - Zeekr client → API exceptions: raises errors
src/zeekr_ev_api/client.py - HTTP request helpers → API exceptions: raises auth errors
src/zeekr_ev_api/network.py