ArgoScuolaNext API
Un programma che ti permette di utilizzare le API di ArgoScuolaNext per gestire e vedere le tue informazioni.
English description of the client
Tabella dei contenuti
Installazione
Puoi installare facilmente questo client di ArgoScuolaNext utilizzando PiP:
pip install argoscuolanextO, se vuoi aggiornare il modulo:
pip install --upgrade argoscuolanextImportare le API
Devi usare import argoscuolanext per importare tutto il modulo.
import argoscuolanext
...Log in
Per fare il login dovrai richiamare la funzione session.login(), con schoolCode (codice della scuola), username e password come parametri.
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")Attività della giornata
Puoi richiamare la query oggi usando la funzione session.oggi(). Puoi, non è obbligatorio, settare anche la data.
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.oggi())Usando una data diversa (yyyy-mm-dd):
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.oggi("2017-10-14"))Output d'esempio:
{
"dati":[
{
"dati":{
"datGiorno":"2017-10-14",
"desMateria":"MATEMATICA",
"numAnno":2017,
"prgMateria":"prgMateria",
"prgClasse":"prgClasse",
"desCompiti":"Matematica: studiare le frazioni.",
"prgScuola":"prgScuola",
"docente":"(Prof. NOME DELL'INSEGNANTE)",
"codMin":"schoolCode"
},
"giorno":"2017-10-14",
"numAnno":2017,
"prgAlunno":"prgAlunno",
"prgScheda":"prgScheda",
"prgScuola":"prgScuola",
"tipo":"COM",
"titolo":"Compiti assegnati",
"ordine":40,
"codMin":"schoolCode"
},
{
"dati":{
"datGiorno":"2017-10-14",
"desMateria":"LINGUA E LETTERATURA ITALIANA",
"numAnno":2017,
"prgMateria":"prgMateria",
"prgClasse":"prgClasse",
"prgScuola":"prgScuola",
"desArgomento":"Verifica d'Italiano.",
"docente":"(Prof. NOME DELL'INSEGNANTE)",
"codMin":"schoolCode"
},
"giorno":"2017-10-14",
"numAnno":2017,
"prgAlunno":"prgAlunno",
"prgScheda":"prgScheda",
"prgScuola":"prgScuola",
"tipo":"ARG",
"titolo":"Argomenti lezione",
"ordine":50,
"codMin":"schoolCode"
}
],
"abilitazioni":{
"ORARIO_SCOLASTICO":true,
"VALUTAZIONI_PERIODICHE":true,
"COMPITI_ASSEGNATI":true,
"TABELLONE_SCRUTINIO_FINALE":true,
"CURRICULUM_VISUALIZZA_FAMIGLIA":false,
"CONSIGLIO_DI_ISTITUTO":true,
"NOTE_DISCIPLINARI":false,
"ACCESSO_CON_CONTROLLO_SCHEDA":true,
"VOTI_GIUDIZI":false,
"VALUTAZIONI_GIORNALIERE":true,
"IGNORA_OPZIONE_VOTI_DOCENTI":false,
"ARGOMENTI_LEZIONE":true,
"CONSIGLIO_DI_CLASSE":false,
"VALUTAZIONI_SOSPESE_PERIODICHE":false,
"PIN_VOTI":false,
"PAGELLE_ONLINE":true,
"RECUPERO_DEBITO_INT":false,
"RECUPERO_DEBITO_SF":false,
"PROMEMORIA_CLASSE":true,
"VISUALIZZA_BACHECA_PUBBLICA":false,
"CURRICULUM_MODIFICA_FAMIGLIA":false,
"TABELLONE_PERIODI_INTERMEDI":false,
"TASSE_SCOLASTICHE":true,
"DOCENTI_CLASSE":false,
"VISUALIZZA_ASSENZE_REG_PROF":true,
"VISUALIZZA_CURRICULUM":false,
"ASSENZE_PER_DATA":true,
"RICHIESTA_CERTIFICATI":false,
"ACCESSO_SENZA_CONTROLLO":true,
"PRENOTAZIONE_ALUNNI":false,
"MODIFICA_RECAPITI":true,
"PAGELLINO_ONLINE":false,
"MEDIA_PESATA":false,
"GIUSTIFICAZIONI_ASSENZE":false
},
"nuoviElementi":0
}Assenze
Puoi richiamare la query assenze usando la funzione session.assenze().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.assenze())Output d'esempio:
{
"dati":[
{
"codEvento":"A",
"numOra":"",
"datGiustificazione":"2017-03-27",
"prgScuola":"prgScuola",
"prgScheda":"prgScheda",
"binUid":"binUid",
"codMin":"schoolCode",
"datAssenza":"2017-03-25",
"numAnno":"2016",
"prgAlunno":"prgAlunno",
"flgDaGiustificare":"1",
"giustificataDa":"(Prof. NOME DELL'INSEGNANTE)",
"desAssenza":"",
"registrataDa":"(Prof. NOME DELL'INSEGNANTE)"
}
]
}Note disciplinari
Puoi richiamare la query notedisciplinari usando la funzione session.notedisciplinari().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.notedisciplinari())Output d'esempio:
{
"dati":[
{
"prgAlunno":"prgAlunno",
"numAnno":"2016",
"flgVisualizzata":"S",
"prgAnagrafe":"prgAnagrafe",
"prgNota":"prgNota",
"prgScheda":"prgScheda",
"prgScuola":"prgScuola",
"desNota":"Lo studente non ha fatto i compiti.",
"datNota":"2018-10-14",
"docente":"(Prof. NOME DELL'INSEGNANTE)",
"codMin":"schoolCode"
}
]
}Voti giornalieri
Puoi richiamare la query votigiornalieri usando la funzione session.votigiornalieri().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.votigiornalieri())Output d'esempio:
{
"dati":[
{
"datGiorno":"2017-04-19",
"desMateria":"GEOGRAFIA",
"prgMateria":"prgMateria",
"prgScuola":"prgScuola",
"prgScheda":"prgScheda",
"codVotoPratico":"N",
"decValore":"7.5",
"codMin":"schoolCode",
"desProva":"",
"codVoto":"7\u00bd",
"numAnno":"2016",
"prgAlunno":"prgAlunno",
"desCommento":"",
"docente":"(Prof NOME DELL'INSEGNANTE)\n)"
}
]
}Voti scrutinio
Puoi richiamare la query votiscrutinio usando la funzione session.votiscrutinio().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.votiscrutinio())Output d'esempio:
{
"dati":[
{
"ordineMateria":"2",
"desMateria":"LINGUA E LET. ITA.",
"votoOrale":{
"codVoto":"7"
},
"prgMateria":"prgMateria",
"prgScuola":"prgScuola",
"prgScheda":"prgScheda",
"votoUnico":"1",
"prgPeriodo":"1",
"assenze":"1",
"codMin":"schoolCode",
"suddivisione":"SO",
"numAnno":"2016",
"prgAlunno":"prgAlunno",
"giudizioSintetico":"",
"prgClasse":"prgClasse"
}
]
}Compiti
Puoi richiamare la query compiti usando la funzione session.compiti().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.compiti())Output d'esempio:
{
"dati":[
{
"datGiorno":"2017-04-22",
"desMateria":"S.I. BIOLOGIA",
"numAnno":"2016",
"prgMateria":"prgMateria",
"prgClasse":"prgClasse",
"desCompiti":"Fare esercizio numero 31 a pagina 2.",
"prgScuola":"2",
"docente":"(Prof. NOME DELL'INSEGNANTE)",
"codMin":"schoolCode"
}
]
}Argomenti delle lezioni
Puoi richiamare la query argomenti usando la funzione session.argomenti().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.argomenti())Output d'esempio:
{
"dati":[
{
"datGiorno":"2017-04-22",
"desMateria":"S.I. BIOLOGIA",
"numAnno":"2016",
"prgMateria":"prgMateria",
"prgClasse":"prgClasse",
"prgScuola":"prgScuola",
"desArgomento":"Abbiamo visto un video.",
"docente":"(Prof. NOME DELL'INSEGNANTE)",
"codMin":"schoolCode\n)"
}
]
}Promemoria
Puoi richiamare la query promemoria usando la funzione session.promemoria().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.promemoria())Output d'esempio:
{
"dati":[
{
"desAnnotazioni":"IT Test",
"datGiorno":"2017-05-11",
"numAnno":"2016",
"prgProgressivo":"prgProgressivo",
"prgClasse":"prgClasse",
"prgAnagrafe":"prgAnagrafe",
"prgScuola":"prgScuola",
"desMittente":"NOME DELL'INSEGNANTE",
"codMin":"schoolCode\n)"
}
]
}Orario
Puoi richiamare la query orario usando la funzione session.orario().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.orario())Output d'esempio:
{
"dati":[
{
"numOra":"1",
"giorno":"Luned\u00ec",
"prgClasse":"prgClasse",
"prgScuola":"prgScuola",
"lezioni":[
{
"materia":"DIRITTO ED ECON.",
"docente":"(Prof. NOME DELL'INSEGNANTE)"
}
],
"numGiorno":"1",
"codMin":"schoolCode"
}
]
}Docenti
Puoi richiamare la query docenticlasse usando la funzione session.docenticlasse().
import argoscuolanext
session = argoscuolanext.Session("SCHOOL-CODE", "USERNAME", "PASSWORD")
print(session.docenticlasse())Output d'esempio:
{
"dati":[
{
"prgClasse":"1967",
"prgAnagrafe":"prgAnagrafe",
"prgScuola":"prgScuola",
"materie":"(S.I. BIOLOGIA)",
"docente":{
"email":"",
"nome":"NOME",
"cognome":"DELL'INSEGNANTE"
},
"codMin":"schoolCode"
}
]
}Log out
Per fare il logout puoi semplicemente eliminare l'oggetto usando del:
...
del session
