v1.3.6 · maelgangloff/kdecole-api@5d1eec6

Kdecole

Support non-officiel de l'API Kdecole (Mon Bureau Numérique, Skolengo, etc.)

L'accès à l'API requiert une en-tête (header) avec la version de l'application en cours d'utilisation.

Le terme "code" ou "password" ne réfère pas ici à votre mot de passe, mais à un code temporaire généré par votre ENT (dans paramètres > application mobile). C'est comme cela que fonctionne l'authentification à l'API.

Les versions à utiliser lors de la création de l'instance Kdecole sont données ci-dessous.

Nom de l'ENT	Version	URL de l'API
Mon Bureau Numérique	3.7.14	https://mobilite.monbureaunumerique.fr/mobilite
Mon ENT Occitanie	3.7.14	https://mobilite.mon-ent-occitanie.fr/mobilite
Arsene 76	3.7.14	https://mobilite.arsene76.fr/mobilite
ENT27	3.7.14	https://mobilite.ent27.fr/mobilite
ENT Creuse	3.7.14	https://mobilite.entcreuse.fr/mobilite
ENT Auvergne-Rhône-Alpes	3.7.14	https://mobilite.ent.auvergnerhonealpes.fr/mobilite
Agora 06	3.7.14	https://mobilite.agora06.fr/mobilite
CyberCollèges 42	3.7.14	https://mobilite.cybercolleges42.fr/mobilite
eCollège 31 Haute-Garonne	3.7.14	https://mobilite.ecollege.haute-garonne.fr/mobilite
Mon collège en Val d'Oise	3.7.14	https://mobilite.moncollege.valdoise.fr/mobilite
Webcollège Seine-Saint-Denis	3.7.14	https://mobilite.webcollege.seinesaintdenis.fr/mobilite
Eclat-BFC	3.7.14	https://mobilite.eclat-bfc.fr/mobilite
@ucollège84	3.7.14	https://mobilite.aucollege84.vaucluse.fr/mobilite
Skolengo Demo	3.7.14	https://mobilite.demo.skolengo.com/mobilite
Kosmos Éducation (aefe, etc.)	3.7.14	https://mobilite.kosmoseducation.com/mobilite
Skolengo formation	3.7.14	https://mobilite.formation.skolengo.com/mobilite
Schulportal Ostbelgien	3.7.14	https://mobilite.schulen.be/mobilite

Une autre méthode pour obtenir un token est d'utiliser la ligne de commande.

npx kdecole-api -u USERNAME -p CODE -ent PROD_MON_BUREAU_NUMERIQUE

Kind: global class

Kdecole
- new Kdecole(authToken, appVersion, idEtablissement, apiURL)
- instance
  - .logout() ⇒ Promise.<void>
  - .starting() ⇒ Promise.<void>
  - .getReleve(idEleve) ⇒ Promise.<Releve>
  - .getActualites(idEleve) ⇒ Promise.<Array.<Actualite>>
  - .getContenuArticle(uid) ⇒ Promise.<ContenuArticle>
  - .getTravailAFaire(idEleve, notBeforeDate) ⇒ Promise.<TravailAFaire>
  - .getContenuActivite(uidSeance, uid, idEleve) ⇒ Promise.<ContenuActivite>
  - .setActiviteFinished(uidSeance, uid, flagRealise) ⇒ Promise.<void>
  - .getAbsences(idEleve) ⇒ Promise.<AbsencesList>
  - .getInfoUtilisateur(idEleve) ⇒ Promise.<Utilisateur>
  - .getCalendrier(idEleve) ⇒ Promise.<Calendrier>
  - .getNotes(idEleve) ⇒ Promise.<NotesList>
  - .getMessagerieInfo() ⇒ Promise.<MessageInfo>
  - .getMessagerieBoiteReception(pagination) ⇒ Promise.<MessageBoiteReception>
  - .getCommunication(id) ⇒ Promise.<Communication>
  - .reportCommunication(id) ⇒ Promise.<void>
  - .deleteCommunication(id) ⇒ Promise.<void>
  - .setCommunicationLu(id) ⇒ Promise.<void>
  - .sendMessage(id, corpsMessage) ⇒ Promise.<void>
  - .gestionAppels() ⇒ Promise.<GestionAppels>
  - .validerAppel(appel) ⇒ Promise.<void>
- static
  - .login(username, password, appVersion, apiUrl) ⇒ Promise.<string>

new Kdecole(authToken, appVersion, idEtablissement, apiURL)

Param	Type	Default	Description
authToken	`string`		Le jeton d'accès
appVersion	`ApiVersion` \| `string`		La version de l'application mobile autorisée par l'API
idEtablissement	`number`	`0`	L'identifiant de l'établissement
apiURL	`ApiUrl` \| `string`		L'URL de l'API Kdecole

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(Kdecole.login(USERNAME, PASSWORD))
// ou encore:
const user = new Kdecole(AUTH_TOKEN)

kdecole.logout() ⇒ `Promise.<void>`

Invalide le jeton d'accès

Kind: instance method of Kdecole
Example

const { Kdecole } = require('kdecole-api')
const user = new Kdecole(authToken)
user.logout()

kdecole.starting() ⇒ `Promise.<void>`

Ping à l'API. Cet appel est initialement réalisé par l'application mobile pour vérifier si le token et la version de l'app sont valides. Le serveur retourne un code de statut HTTP 204 No Content si l'utilisateur est correctement authentifié.

Kind: instance method of Kdecole
Example

const { Kdecole } = require('kdecole-api')
const user = new Kdecole(authToken)
try {
  user.starting()
}
catch (e) {
  // Une exception est levée si l'utilisateur n'est pas correctement authentifié
}

kdecole.getReleve(idEleve) ⇒ `Promise.<Releve>`

Retourne le relevé de notes de l'élève

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

kdecole.getReleve() //Retourne le relevé de l'élève
kdecole.getReleve(idEleve) //Retourne le relevé d'un élève précis

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getReleve(idEleve).then(releve => {
 // Votre code
 releve.toCSV() // Exporter son relevé des notes dans un objet contenant les devoirs au format CSV
 })

kdecole.getActualites(idEleve) ⇒ `Promise.<Array.<Actualite>>`

Retourne un tableau des actualités de l'établissement de l'utilisateur

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getActualites(idEleve).then(actualites => {
 // Votre code
 })

kdecole.getContenuArticle(uid) ⇒ `Promise.<ContenuArticle>`

Retourne le contenu d'un article

Kind: instance method of Kdecole

Param	Type	Description
uid	`string`	Identifiant unique de l'article

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getContenuArticle(uid).then(contenuArticle => {
 // Votre code
 })

kdecole.getTravailAFaire(idEleve, notBeforeDate) ⇒ `Promise.<TravailAFaire>`

Retourne la liste des devoirs de l'élève

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève
notBeforeDate	`Date`	Un objet Date pour ne sélectionner que les devoirs postérieurs à une date

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getTravailAFaire(idEleve).then(taf => {
 // Votre code
 })

kdecole.getContenuActivite(uidSeance, uid, idEleve) ⇒ `Promise.<ContenuActivite>`

Retourne les détails d'un devoir à faire

Kind: instance method of Kdecole

Param	Type	Description
uidSeance	`number`	Identifiant de la séance
uid	`number`	Identifiant du devoir à faire
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getContenuActivite(uidSeance, uid, idEleve).then(contenuActivite => {
 // Votre code
 })

kdecole.setActiviteFinished(uidSeance, uid, flagRealise) ⇒ `Promise.<void>`

Permet de marquer un devoir comme étant fait

Kind: instance method of Kdecole

Param	Type	Description
uidSeance	`number`	Identifiant de la séance
uid	`number`	Identifiant du devoir
flagRealise	`boolean`	Statut du devoir

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.setActiviteFinished(uidSeance, uid, flagRealise)

kdecole.getAbsences(idEleve) ⇒ `Promise.<AbsencesList>`

Retourne la liste des absences d'un élève

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getAbsences(idEleve).then(absences => {
 // Votre code
 })

kdecole.getInfoUtilisateur(idEleve) ⇒ `Promise.<Utilisateur>`

Retourne les informations d'un utilisateur (type de compte, nom complet, numéro de l'établiissement, etc.)

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getInfoUtilisateur(idEleve).then(infoUtilisateur => {
 // Votre code
 })

kdecole.getCalendrier(idEleve) ⇒ `Promise.<Calendrier>`

Retourne l'emploi du temps de l'élève à J-7 et J+7

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getCalendrier(idEleve).then(calendrier => {
 // Votre code
 })

kdecole.getNotes(idEleve) ⇒ `Promise.<NotesList>`

Retourne la liste des récentes notes de l'élève

Kind: instance method of Kdecole

Param	Type	Description
idEleve	`string`	Identifiant d'un élève

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getNotes(idEleve).then(notes => {
 // Votre code
 })

kdecole.getMessagerieInfo() ⇒ `Promise.<MessageInfo>`

Retourne l'état de la messagerie de l'utilisateur (nombre de mails non lus)

Kind: instance method of Kdecole
Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getMessagerieInfo().then(messagerieInfo => {
 // Votre code
 })

kdecole.getMessagerieBoiteReception(pagination) ⇒ `Promise.<MessageBoiteReception>`

Retourne les mails présents dans la boîte mail Le paramètre pagination permet de remonter dans le passé dans la liste des fils de discussions

Kind: instance method of Kdecole

Param	Type	Default	Description
pagination	`number`	`0`	Le nombre de fils de discussion à tronquer (système de pagination)

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getMessagerieBoiteReception().then(messagerieBoiteReception => {
 // Votre code
 })

kdecole.getCommunication(id) ⇒ `Promise.<Communication>`

Retourne les détails d'un fil de discussion

Kind: instance method of Kdecole

Param	Type	Description
id	`number`	Identifiant d'un fil de discussion

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.getCommunication(id).then(communication => {
 // Votre code
 })

kdecole.reportCommunication(id) ⇒ `Promise.<void>`

Permet de signaler une communication

Kind: instance method of Kdecole

Param	Type	Description
id	`number`	Identifiant d'un fil de discussion

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.reportCommunication(id)

kdecole.deleteCommunication(id) ⇒ `Promise.<void>`

Supprime la communication

Kind: instance method of Kdecole

Param	Type	Description
id	`number`	Identifiant d'un fil de discussion

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.deleteCommunication(id)

kdecole.setCommunicationLu(id) ⇒ `Promise.<void>`

Marquer une communication lue

Kind: instance method of Kdecole

Param	Type	Description
id	`number`	Identifiant d'un fil de discussion

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.setCommunicationLu(id)

kdecole.sendMessage(id, corpsMessage) ⇒ `Promise.<void>`

Envoyer un message sur un fil de discussion

Kind: instance method of Kdecole

Param	Type	Description
id	`number`	Identifiant d'un fil de discussion
corpsMessage	`string`	Corps du message HTML

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.sendMessage(id, corpsMessage)

kdecole.gestionAppels() ⇒ `Promise.<GestionAppels>`

Retourne les feuilles d'appel.

Kind: instance method of Kdecole
Returns: Promise.<GestionAppels> - Les feuilles d'appel.
Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
user.gestionAppels().then(gestionAppels => {
 // Votre code
 })

kdecole.validerAppel(appel) ⇒ `Promise.<void>`

Valide l'appel de la classe.

Kind: instance method of Kdecole

Param	Description
appel	L'appel à valider

Example

const { Kdecole } = require('kdecole-api')

const user = new Kdecole(AUTH_TOKEN)
const appel = {
  "idEtab": 10485,
  "idAppel": 534552,
  "listeAbsencesAppel": [
    {
      "idEleve": "AAP05567",
      "type": "absence",
      "dateDebut": 1609259443000,
      "dateFin": 1609263043000,
      "modifiable": true
    }
  ]
}
user.validerAppel(appel)

Kdecole.login(username, password, appVersion, apiUrl) ⇒ `Promise.<string>`

Retourne le jeton d'accès de l'utilisateur

Kind: static method of Kdecole

Param	Type	Description
username	`string`	Le nom d'utilisateur
password	`string`	Le mot de passe à usage unique
appVersion	`ApiVersion` \| `string`	La version de l'application mobile autorisée par l'API
apiUrl	`apiURL` \| `string`	L'URL de l'API Kdecole

Example

const { Kdecole, ApiUrl, ApiVersion } = require('kdecole-api')
Kdecole.login(username, uniquePassword, ApiVersion.PROD_MON_BUREAU_NUMERIQUE, ApiUrl.PROD_MON_BUREAU_NUMERIQUE).then(token => console.log(token)) // Affiche son token dans la console

-Original file line number
+Diff line change
@@ -1,14 +1,14 @@
 {
  "name": "kdecole-api",
- "version": "1.3.1",
+ "version": "1.3.6",
  "main": "dist/Kdecole.js",
  "types": "types/Kdecole.d.ts",
  "bin": {
  "kdecole": "bin/kdecole-api"
  },
  "author": {
  "name": "Maël Gangloff",
- "email": "[email protected]"
+ "email": "[email protected]"
  },
  "license": "ISC",
  "homepage": "https://github.com/maelgangloff/kdecole-api#readme",
@@ Expand Down @@

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Commit

There are no files selected for viewing

No visible changes here.

Kdecole

new Kdecole(authToken, appVersion, idEtablissement, apiURL)

kdecole.logout() ⇒ `Promise.<void>`

kdecole.starting() ⇒ `Promise.<void>`

kdecole.getReleve(idEleve) ⇒ `Promise.<Releve>`

kdecole.getActualites(idEleve) ⇒ `Promise.<Array.<Actualite>>`

kdecole.getContenuArticle(uid) ⇒ `Promise.<ContenuArticle>`

kdecole.getTravailAFaire(idEleve, notBeforeDate) ⇒ `Promise.<TravailAFaire>`

kdecole.getContenuActivite(uidSeance, uid, idEleve) ⇒ `Promise.<ContenuActivite>`

kdecole.setActiviteFinished(uidSeance, uid, flagRealise) ⇒ `Promise.<void>`

kdecole.getAbsences(idEleve) ⇒ `Promise.<AbsencesList>`

kdecole.getInfoUtilisateur(idEleve) ⇒ `Promise.<Utilisateur>`

kdecole.getCalendrier(idEleve) ⇒ `Promise.<Calendrier>`

kdecole.getNotes(idEleve) ⇒ `Promise.<NotesList>`

kdecole.getMessagerieInfo() ⇒ `Promise.<MessageInfo>`

kdecole.getMessagerieBoiteReception(pagination) ⇒ `Promise.<MessageBoiteReception>`

kdecole.getCommunication(id) ⇒ `Promise.<Communication>`

kdecole.reportCommunication(id) ⇒ `Promise.<void>`

kdecole.deleteCommunication(id) ⇒ `Promise.<void>`

kdecole.setCommunicationLu(id) ⇒ `Promise.<void>`

kdecole.sendMessage(id, corpsMessage) ⇒ `Promise.<void>`

kdecole.gestionAppels() ⇒ `Promise.<GestionAppels>`

kdecole.validerAppel(appel) ⇒ `Promise.<void>`

Kdecole.login(username, password, appVersion, apiUrl) ⇒ `Promise.<string>`

0 comments on commit `5d1eec6`

Commit

There are no files selected for viewing

No visible changes here.

Kdecole

new Kdecole(authToken, appVersion, idEtablissement, apiURL)

kdecole.logout() ⇒ Promise.<void>

kdecole.starting() ⇒ Promise.<void>

kdecole.getReleve(idEleve) ⇒ Promise.<Releve>

kdecole.getActualites(idEleve) ⇒ Promise.<Array.<Actualite>>

kdecole.getContenuArticle(uid) ⇒ Promise.<ContenuArticle>

kdecole.getTravailAFaire(idEleve, notBeforeDate) ⇒ Promise.<TravailAFaire>

kdecole.getContenuActivite(uidSeance, uid, idEleve) ⇒ Promise.<ContenuActivite>

kdecole.setActiviteFinished(uidSeance, uid, flagRealise) ⇒ Promise.<void>

kdecole.getAbsences(idEleve) ⇒ Promise.<AbsencesList>

kdecole.getInfoUtilisateur(idEleve) ⇒ Promise.<Utilisateur>

kdecole.getCalendrier(idEleve) ⇒ Promise.<Calendrier>

kdecole.getNotes(idEleve) ⇒ Promise.<NotesList>

kdecole.getMessagerieInfo() ⇒ Promise.<MessageInfo>

kdecole.getMessagerieBoiteReception(pagination) ⇒ Promise.<MessageBoiteReception>

kdecole.getCommunication(id) ⇒ Promise.<Communication>

kdecole.reportCommunication(id) ⇒ Promise.<void>

kdecole.deleteCommunication(id) ⇒ Promise.<void>

kdecole.setCommunicationLu(id) ⇒ Promise.<void>

kdecole.sendMessage(id, corpsMessage) ⇒ Promise.<void>

kdecole.gestionAppels() ⇒ Promise.<GestionAppels>

kdecole.validerAppel(appel) ⇒ Promise.<void>

Kdecole.login(username, password, appVersion, apiUrl) ⇒ Promise.<string>

0 comments on commit 5d1eec6

kdecole.logout() ⇒ `Promise.<void>`

kdecole.starting() ⇒ `Promise.<void>`

kdecole.getReleve(idEleve) ⇒ `Promise.<Releve>`

kdecole.getActualites(idEleve) ⇒ `Promise.<Array.<Actualite>>`

kdecole.getContenuArticle(uid) ⇒ `Promise.<ContenuArticle>`

kdecole.getTravailAFaire(idEleve, notBeforeDate) ⇒ `Promise.<TravailAFaire>`

kdecole.getContenuActivite(uidSeance, uid, idEleve) ⇒ `Promise.<ContenuActivite>`

kdecole.setActiviteFinished(uidSeance, uid, flagRealise) ⇒ `Promise.<void>`

kdecole.getAbsences(idEleve) ⇒ `Promise.<AbsencesList>`

kdecole.getInfoUtilisateur(idEleve) ⇒ `Promise.<Utilisateur>`

kdecole.getCalendrier(idEleve) ⇒ `Promise.<Calendrier>`

kdecole.getNotes(idEleve) ⇒ `Promise.<NotesList>`

kdecole.getMessagerieInfo() ⇒ `Promise.<MessageInfo>`

kdecole.getMessagerieBoiteReception(pagination) ⇒ `Promise.<MessageBoiteReception>`

kdecole.getCommunication(id) ⇒ `Promise.<Communication>`

kdecole.reportCommunication(id) ⇒ `Promise.<void>`

kdecole.deleteCommunication(id) ⇒ `Promise.<void>`

kdecole.setCommunicationLu(id) ⇒ `Promise.<void>`

kdecole.sendMessage(id, corpsMessage) ⇒ `Promise.<void>`

kdecole.gestionAppels() ⇒ `Promise.<GestionAppels>`

kdecole.validerAppel(appel) ⇒ `Promise.<void>`

Kdecole.login(username, password, appVersion, apiUrl) ⇒ `Promise.<string>`

0 comments on commit `5d1eec6`