Hyperplanning

L'endpoint /hyperplanning permet d'afficher les informations d'un emploi du temps Hyperplanning au format JSON à partir d'un fichier ICS (calendrier).

POST/v3/hyperplanning

Paramètres

Paramètre	Requis	Description
url	Oui	L'URL du fichier ICS à utiliser et afficher. Doit être encodée en URL avant l'envoi
detail	Non	Niveau de détail pour les événements (full ou list)

Options de détail

Option	Description
full	Affiche un résumé complet avec matière, enseignant, classes, date, etc.
list	Affiche toutes les données sous forme de liste

Exemple de requête

curl -X POST -d "url=https%3A%2F%2Fexample.com%2Ffile.ics&detail=full" "https://api.sylvain.sh/v3/hyperplanning"

Réponse

[
    {
        "summary": ["Mathematics", "DOE", "Class", "1", "Class", "2"],
        "subject": "Mathematics",
        "teacher": "DOE",
        "classes": ["Class 1", "Class 2"],
        "start": "2000-03-01T12:00:00.000",
        "end": "2000-03-01T14:00:00.000"
    }
]

Champs de réponse

Champ	Description
summary	Tableau des éléments du résumé
subject	Nom de la matière
teacher	Nom de l'enseignant
classes	Tableau des noms de classes
start	Heure de début de l'événement (ISO 8601)
end	Heure de fin de l'événement (ISO 8601)

Gestion des erreurs

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

Message d'erreur	Description
Please provide a valid ICS file URL (?url={URL})	Le paramètre url est manquant ou invalide