hardbyte / hardbyte/python-evnex

API surface discovered from the official web app not yet wrapped

オープン
#119 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Python
スター
13
フォーク
8
平均マージ
5時間 58分
マージ済み PR(30日)
2

説明

Captured by driving the official web app (app.evnex.io) with network recording, alongside the endpoints the library already wraps. Response shapes verified against a live account.

## Unwrapped endpoints

- `GET /v2/apps/organisations/{org}/locations` — org locations with address, coordinates, ICP number/retailer/distributor details, timezone, and (via `included`) full charge point objects. A natural `get_org_locations()` + schema.
- `GET /organisations/{org}/summary/status` — connector-state counts (`available/charging/disabled/faulted/occupied/offline/reserved`) under `data.attributes.connectors`. Note the library currently wraps the older `/v2/apps/...` variant with a flat shape; the app uses this newer one.
- `GET /v2/apps/organisations/{org}/tokens` — RFID/charge tokens (403 on a Free-tier org, so schema unknown; likely paid orgs only).

## App-only commands observed (not captured, not invoked)

The charge point page exposes Charge / Unlock / Disable / **Reload charge point** buttons. Unlock/availability are already wrapped; "reload" (reboot) is not — likely `POST /charge-points/{id}/commands/...`. Worth capturing the exact command name before wrapping.

## Also noted

- The app authenticates with a different Cognito app client id than the library's; both work against the same API.
- An unauthenticated `cognito-identity` federated call fails 400 and is retried silently by the app — not needed for API access.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

調査の方向性

Start by reading the existing organization location and status wrappers and their schemas, then compare them with the captured routes and live response shapes described here. Verify the paid-tier token response before handling it, and capture the reload command separately; done means the confirmed endpoints and schemas are wrapped without guessing the unobserved command.

索引モデルが issue の本文から書いたものです。

評価

技術スタック
python
領域
api, backend
issue の種類
機能追加
難易度
4/5
見積もり時間
3〜5日
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
48/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。