Skip to content

Commit b70ec39

Browse files
Clément VALENTINclaude
andcommitted
docs: update OAuth callback endpoint from /consent to /oauth/callback
- Update SECURITY.md with new endpoint path and validation details - Update docker.md with new ENEDIS_REDIRECT_URI examples - Update gateway.md flow documentation 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 99f3131 commit b70ec39

File tree

3 files changed

+7
-7
lines changed

3 files changed

+7
-7
lines changed

apps/api/SECURITY.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,10 @@ Cette fonction :
7777
**Localisation** : `src/routers/oauth.py` et `src/main.py`
7878

7979
-**Autorisation** (`/oauth/authorize`) : génère URL Enedis avec `state=user_id` uniquement
80-
-**Consentement** (`/consent`) :
81-
- Récupère tous les PDL via `/customers_upc/v5/usage_points`
80+
-**Callback** (`/oauth/callback`) :
81+
- Valide le format du PDL (14 chiffres exactement)
8282
- Crée automatiquement les PDL détectés
83-
- Crée les tokens OAuth pour chaque PDL (même token partagé pour tous les PDL)
83+
- Récupère les infos du contrat (puissance souscrite, heures creuses)
8484
-**Refresh** : vérifie propriété PDL avant refresh
8585
-**Cascade delete** : suppression compte → suppression tokens
8686

@@ -108,7 +108,7 @@ Tous les endpoints suivants vérifient l'authentification ET la propriété des
108108

109109
#### OAuth
110110
- `GET /oauth/authorize` - Génère URL Enedis (pas de PDL requis)
111-
- `GET /consent` - Callback Enedis, récupère tous les PDL automatiquement
111+
- `GET /oauth/callback` - Callback Enedis, valide et crée les PDL automatiquement
112112
- `POST /oauth/refresh/{usage_point_id}` - **Vérifie propriété PDL**
113113

114114
#### Données Enedis

docs/features-spec/05-gateway.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Mettre à disposition une API passerelle entre les utilisateurs finaux et Enedis
2020
2. L'utilisateur crée un compte sur la passerelle (email, mot de passe).
2121
3. Depuis son tableau de bord, l'utilisateur clique sur **"Consentement Enedis"** (pas besoin de saisir de PDL).
2222
4. La passerelle génère l'URL d'autorisation Enedis avec `state=user_id` :<br>`https://mon-compte-particulier.enedis.fr/dataconnect/v1/oauth2/authorize?client_id=XXXXXXXX&duration=P36M&response_type=code&state={user_id}`
23-
5. Après validation du consentement sur le portail Enedis, celui-ci redirige vers `http://localhost:8000/consent?code=XXX&state={user_id}`.
23+
5. Après validation du consentement sur le portail Enedis, celui-ci redirige vers `http://localhost:8000/oauth/callback?code=XXX&state={user_id}&usage_point_id={pdl}`.
2424
6. La passerelle :
2525
- Échange le code contre un token OAuth
2626
- Appelle l'API Enedis `/customers_upc/v5/usage_points` pour récupérer **tous les PDL** du compte

docs/setup/docker.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,13 +70,13 @@ Ces identifiants sont obtenus sur le [portail développeur Enedis](https://datah
7070
|----------|-------------|---------|
7171
| `ENEDIS_CLIENT_ID` | Identifiant de votre application Enedis | `abc123def456` |
7272
| `ENEDIS_CLIENT_SECRET` | Secret de votre application Enedis | `secret789xyz` |
73-
| `ENEDIS_REDIRECT_URI` | URL de callback OAuth2 (doit correspondre à celle déclarée sur Enedis) | `https://myelectricaldata.fr/consent` |
73+
| `ENEDIS_REDIRECT_URI` | URL de callback OAuth2 (doit correspondre à celle déclarée sur Enedis) | `https://myelectricaldata.fr/oauth/callback` |
7474
| `ENEDIS_ENVIRONMENT` | Environnement API : `sandbox` (données fictives) ou `production` (données réelles) | `production` |
7575

7676
```bash
7777
ENEDIS_CLIENT_ID=votre-client-id
7878
ENEDIS_CLIENT_SECRET=votre-client-secret
79-
ENEDIS_REDIRECT_URI=https://myelectricaldata.fr/consent
79+
ENEDIS_REDIRECT_URI=https://myelectricaldata.fr/oauth/callback
8080
ENEDIS_ENVIRONMENT=production
8181
```
8282

0 commit comments

Comments
 (0)