Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

API surface discovered from the official web app not yet wrapped

Ouverte
#119 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
48/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Calme
Stack technique
python
Domaine
api, backend

Piste de recherche

Commencez par lire les wrappers existants de localisation et de statut de l’organisation ainsi que leurs schemas, puis comparez-les aux routes capturées et aux formes des réponses en direct décrites ici. Vérifiez la réponse de token du niveau payant avant de la traiter et capturez séparément la commande de reload ; le travail est terminé lorsque les endpoints et les schemas confirmés sont encapsulés, sans deviner la commande non observée.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.
Langage dominant
Python
Étoiles
13
Forks
8
Merge moyen
5 h 58 min
PR mergées (30 j)
2

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de hardbyte/python-evnex

Toutes les issues de hardbyte/python-evnex

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.