Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

API surface discovered from the official web app not yet wrapped

Đang mở
  • Có gì không ổn?
#119 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
python
Lĩnh vực
api, backend

Hướng nghiên cứu

Bắt đầu bằng cách đọc các wrapper hiện có cho vị trí và trạng thái của tổ chức cùng các schema của chúng, sau đó so sánh chúng với các route đã được ghi nhận và các dạng response trực tiếp được mô tả ở đây. Xác minh token response của paid-tier trước khi xử lý nó, đồng thời ghi nhận riêng reload command; được xem là hoàn tất khi các endpoint và schema đã được xác nhận được bọc lại mà không đoán command chưa được quan sát.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.
Ngôn ngữ chính
Python
Star
13
Fork
8
Merge trung bình
3 giờ 23 phút
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Chúng tôi chưa kiểm tra các tệp thiết lập môi trường của dự án này. Hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của hardbyte/python-evnex

Tất cả issue của hardbyte/python-evnex

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.