bridgeDirecte 🌸 Flower 1.1

RESTful API bridge for EcoleDirecte, powered by wrapdirecte and Cloudflare Workers.

Utilisation

Le bridge peut être utilisé de deux manières :

1. via npm (recommandé)

Vous pouvez utiliser bridgedirecte comme une bibliothèque dans votre propre Worker Cloudflare.

import { createBridge } from 'bridgedirecte'

// Exportation de l'instance configurée
export default createBridge({
  allowedOrigins: ['https://votre-site.com'], // défaut ["*"]
  appName: 'monApplication', // défaut: nom dans package.json
  appVersion: '1.0.0', // défaut: version dans package.json
  forceHttps: true, // refuse les requêtes non sécurisées, défaut true
})

Si vous souhaitez simplement faire une nouvelle instance vierge :

git clone https://bridge.directe.qzz.io/new
npm i
npx wrangler deploy

Vous pourrez modifier les paramètres de configuration dans le fichier worker.js.

2. par clonage du code source

git clone https://bridge.directe.qzz.io/sourcecode

Si vous clonez le code source directement, vous pouvez configurer l'instance via un fichier bridgedirecte.config.jsonc à la racine du projet :

{
  "allowedOrigins": ["*"],
  "appName": "bridgeDirecteCustom",
  "appVersion": "1.0.0",
  "forceHttps": true,
}

Configuration

Réglage	Description	Défaut
`allowedOrigins`	Liste des origines autorisées (CORS)	`["*"]`
`appName`	Nom de l'application (User-Agent)	`package.json`
`appVersion`	Version de l'application (User-Agent)	`package.json`
`forceHttps`	Exiger HTTPS (sauf localhost)	`true`

Caution

Si vous fournissez des réglages à createBridge() ET qu'un fichier bridgedirecte.config.jsonc est présent, le bridge renverra une erreur "Bad config".

Authentification

Le bridge est stateless. Chaque requête (sauf /login et /login/2fa) nécessite :

Header	Description	Exemple
`Authorization`	Token Bearer obtenu après `/login`	`Bearer eyJhbGci...`
`Account-ID`	ID numérique du compte élève à utiliser	`1234`

Endpoints

🔐 Authentification

`POST /login`

Connexion avec identifiants EcoleDirecte.

Query (Optionnel) : ?direct=true pour bypasser le 2FA si vous avez un 2faProof.

Body :

{
  "username": "mon.identifiant",
  "password": "monMotDePasse",
  "2faProof": "mon2faProof (requis si direct=true)",
  "uuid": "optionnel-uuid",
  "preferredAccountId": 123456
}

Réponse (succès) :

{
  "success": true,
  "status": "authenticated",
  "token": "eyJhbGci...",
  "faProof": "leProofAStocker",
  "accounts": [{ "id": 123456, "firstName": "Jean", "lastName": "Dupont" }]
}

Réponse (2FA requis) :

{
  "success": true,
  "status": "needs_2fa",
  "challenge": {
    "question": "Quel est le prénom de votre professeur principal ?",
    "proposals": []
  },
  "partialToken": "eyJhbGci..."
}

`POST /login/2fa`

Soumettre la réponse 2FA.

Headers requis : Authorization: Bearer <partial_token>

Body :

{
  "answer": "reponse",
  "username": "votre_username",
  "password": "votre_password",
  "uuid": "optionnel"
}

Réponse :

{
  "success": true,
  "status": "authenticated",
  "token": "eyJhbGci...",
  "faProof": "leProofAStocker",
  "accounts": [{ "id": 123456 }]
}

`GET /login/status`

Vérifier le statut d'authentification de la session en cours.

Headers requis : Authorization: Bearer <token>

Réponse :

{
  "success": true,
  "isAuthenticated": true,
  "accountId": 123456
}

📚 Notes

`GET /grades`

Headers : Authorization, Account-ID
Query : ?year=2025-2026 (défaut : année scolaire en cours)

Réponse :

{
  "grades": [...],
  "periods": [...],
  "settings": {}
}

📝 Devoirs

`GET /homework`

Headers : Authorization, Account-ID
Query : ?date=2026-04-08 (défaut : aujourd'hui)

Réponse : CleanHomework[]

`PATCH /homework`

Marquer un devoir comme fait ou non fait.

Headers : Authorization, Account-ID
Query : ?id=<homeworkId>

Body :

{ "done": true }

Réponse :

{ "success": true, "id": 987654, "done": true }

`POST /homework/:id/comment`

Ajouter un commentaire à un devoir.

Headers : Authorization, Account-ID

Body :

{ "content": "Mon commentaire" }

Réponse :

{ "success": true, "commentId": 111 }

📅 Emploi du temps

`GET /timetable`

Headers : Authorization, Account-ID
Query : ?from=2026-04-01&to=2026-04-07 (défaut : semaine courante)

Réponse : CleanCourse[]

`GET /timetable/ical`

Headers : Authorization, Account-ID

Réponse :

{ "success": true, "url": "https://api.ecoledirecte.com/ical/..." }

🚫 Absences

`GET /absences`

Headers : Authorization, Account-ID

Réponse : CleanAbsence[]

📰 Timeline

`GET /timeline`

Timeline personnelle de l'élève.

Headers : Authorization, Account-ID

Réponse : CleanTimelineEvent[]

`GET /timeline/school`

Timeline commune (toute l'école).

Headers : Authorization, Account-ID

Réponse :

{
  "events": [...],
  "postits": [...]
}

📄 Documents

`GET /documents`

Headers : Authorization, Account-ID

Réponse :

{
  "factures": [...],
  "notes": [...]
}

☁️ Cloud

`GET /cloud`

Headers : Authorization, Account-ID
Query : ?depth=3 (défaut : 3)

Réponse : CleanCloudNode[]

`POST /cloud/folder`

Créer un dossier.

Headers : Authorization, Account-ID

Body :

{ "path": "parent/chemin", "name": "nouveauDossier" }

`POST /cloud/copy`

Copier des fichiers/dossiers.

Body :

{ "destination": "dest/chemin", "nodes": [...] }

`POST /cloud/move`

Déplacer des fichiers/dossiers.

Body :

{ "destination": "dest/chemin", "nodes": [...] }

`DELETE /cloud`

Supprimer des fichiers/dossiers.

Body :

{ "nodes": [...] }

`POST /cloud/restore`

Restaurer des fichiers/dossiers supprimés.

Body :

{ "nodes": [...] }

`POST /cloud/export`

Exporter un fichier vers le cloud.

Body :

{
  "fileId": "abc123",
  "source": "CAHIER_DE_TEXTES"
}

source : "CAHIER_DE_TEXTES" ou "MESSAGERIE"

`POST /cloud/upload`

Téléverser un fichier vers le cloud.

Headers requis : Authorization, Account-ID

Body (multipart/form-data) :

file : Le fichier à téléverser.
dest (ou destPath, optionnel) : Le chemin de destination dans le cloud (défaut : /).

Réponse :

{
  "success": true,
  "message": "Fichier téléversé avec succès"
}

✉️ Messagerie

`GET /messages`

Headers : Authorization, Account-ID
Query : ?year=2025-2026

Réponse :

{
  "received": [...],
  "sent": [...],
  "draft": [...],
  "archived": [...],
  "folders": [...]
}

`GET /messages/:id`

Contenu complet d'un message.

Headers : Authorization, Account-ID
Query : ?year=2025-2026&glance=true (glance=true marque le message comme non lu lors de l'ouverture)

Réponse : CleanMessage avec champ content

`GET /messages/folder/:folderId`

Messages d'un dossier spécifique.

Headers : Authorization, Account-ID

Réponse : CleanMessage[]

`GET /messages/contacts/:type`

Récupérer les contacts.

Headers : Authorization, Account-ID
Paramètre : :type = professeurs | personnels | entreprises

Réponse : Contact[]

`POST /messages`

Envoyer un message.

Headers : Authorization, Account-ID

Body :

{
  "subject": "Objet du message",
  "content": "Contenu du message",
  "recipients": [{ "id": 123, "type": "P" }],
  "year": "2025-2026"
}

Réponse :

{ "success": true, "messageId": 456789 }

`PUT /messages/:id/read`

Marquer un message comme lu.

Headers : Authorization, Account-ID
Query : ?year=2025-2026

Réponse :

{ "success": true }

`PUT /messages/:id/unread`

Marquer un message comme non lu.

Headers : Authorization, Account-ID
Query : ?year=2025-2026

Réponse :

{ "success": true }

`PUT /messages/:id/archive`

Archiver un message.

Headers : Authorization, Account-ID
Query : ?year=2025-2026

Réponse :

{ "success": true }

`PUT /messages/:id/unarchive`

Désarchiver un message.

Headers : Authorization, Account-ID
Query : ?year=2025-2026

Réponse :

{ "success": true }

`PATCH /messages/:id/move`

Déplacer un message vers un autre dossier.

Headers : Authorization, Account-ID

Body :

{ "folder": 12345 }

Réponse :

{ "success": true }

`POST /messages/folder`

Créer un nouveau dossier.

Headers : Authorization, Account-ID

Body :

{ "name": "Nom du dossier" }

Réponse :

{ "success": true, "id": 12345 }

`DELETE /messages/folder/:folderId`

Supprimer un dossier.

Headers : Authorization, Account-ID

Réponse :

{ "success": true }

⚙️ Paramètres

`GET /settings`

Headers : Authorization, Account-ID
Query : ?loginId=123 (optionnel)

`PATCH /settings`

Mettre à jour les paramètres du compte.

Headers : Authorization, Account-ID

Body :

{
  "identifiant": "nouvelIdentifiant",
  "nouveauMotDePasse": "nouveauMotDePasse",
  "confirmationMotDePasse": "nouveauMotDePasse",
  "email": "nouveau@email.com",
  "portable": "0612345678",
  "questionSecrete": "Question secrète",
  "reponse": "Réponse",
  "uuid": "optionnel"
}

`PATCH /settings/param`

Mettre à jour un paramètre individuel.

Headers : Authorization, Account-ID

Body :

{ "value": "nouvelle-valeur" }

Format des erreurs

Toutes les erreurs suivent ce format :

{
  "success": false,
  "error": "Description de l'erreur",
  "code": 400
}

Code	Signification
400	Requête invalide (body, params)
401	Non authentifié / token invalide
404	Route introuvable
500	Erreur interne du serveur
503	Module indisponible

IP Spoofing

Le bridge injecte automatiquement un header X-Forwarded-For avec une IP française aléatoire sur chaque requête vers EcoleDirecte, en utilisant les préfixes des principaux opérateurs :

Préfixe	Opérateur
`80.12.*`	Orange
`82.224.*`	Free
`176.128.*`	SFR
`90.1.*`	Orange Mobile

Licence

AGPL 3.0 — Voir LICENSE pour les détails.

Name		Name	Last commit message	Last commit date
Latest commit History 50 Commits
src		src
.gitignore		.gitignore
.npmignore		.npmignore
.prettierrc		.prettierrc
LICENSE		LICENSE
README.md		README.md
package.json		package.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts
wrangler.jsonc		wrangler.jsonc

Folders and files

Latest commit

History

Repository files navigation

bridgeDirecte 🌸 Flower 1.1

Utilisation

1. via npm (recommandé)

2. par clonage du code source

Configuration

Authentification

Endpoints

🔐 Authentification

POST /login

POST /login/2fa

GET /login/status

📚 Notes

GET /grades

📝 Devoirs

GET /homework

PATCH /homework

POST /homework/:id/comment

📅 Emploi du temps

GET /timetable

GET /timetable/ical

🚫 Absences

GET /absences

📰 Timeline

GET /timeline

GET /timeline/school

📄 Documents

GET /documents

☁️ Cloud

GET /cloud

POST /cloud/folder

POST /cloud/copy

POST /cloud/move

DELETE /cloud

POST /cloud/restore

POST /cloud/export

POST /cloud/upload

✉️ Messagerie

GET /messages

GET /messages/:id

GET /messages/folder/:folderId

GET /messages/contacts/:type

POST /messages

PUT /messages/:id/read

PUT /messages/:id/unread

PUT /messages/:id/archive

PUT /messages/:id/unarchive

PATCH /messages/:id/move

POST /messages/folder

DELETE /messages/folder/:folderId

⚙️ Paramètres

GET /settings

PATCH /settings

PATCH /settings/param

Format des erreurs

IP Spoofing

Licence

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`POST /login`

`POST /login/2fa`

`GET /login/status`

`GET /grades`

`GET /homework`

`PATCH /homework`

`POST /homework/:id/comment`

`GET /timetable`

`GET /timetable/ical`

`GET /absences`

`GET /timeline`

`GET /timeline/school`

`GET /documents`

`GET /cloud`

`POST /cloud/folder`

`POST /cloud/copy`

`POST /cloud/move`

`DELETE /cloud`

`POST /cloud/restore`

`POST /cloud/export`

`POST /cloud/upload`

`GET /messages`

`GET /messages/:id`

`GET /messages/folder/:folderId`

`GET /messages/contacts/:type`

`POST /messages`

`PUT /messages/:id/read`

`PUT /messages/:id/unread`

`PUT /messages/:id/archive`

`PUT /messages/:id/unarchive`

`PATCH /messages/:id/move`

`POST /messages/folder`

`DELETE /messages/folder/:folderId`

`GET /settings`

`PATCH /settings`

`PATCH /settings/param`

Packages