Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

API surface discovered from the official web app not yet wrapped

未关闭
#119 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
48/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
冷清
技术栈
python
领域
api, backend

调研方向

先阅读现有的组织位置和状态 wrappers 及其 schemas,然后将它们与此处描述的已捕获 routes 和实时 response 形状进行比较。在处理付费层级的 token response 之前先验证它,并单独捕获 reload command;不猜测未观测到的 command,完成对已确认 endpoints 和 schemas 的封装后,才算完成。

由索引模型根据 Issue 内容生成。

描述

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.
主要语言
Python
星标
13
派生
8
平均合并
5 小时 58 分钟
30 天内合并 PR
2

贡献指南

这个仓库没有索引到贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

hardbyte/python-evnex 的其他 Issue

查看 hardbyte/python-evnex 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。