hearot/argoscuolanext

A client for the ArgoScuolaNext APIs


Keywords
php, api, School, argo, scuola, scuolanext, apiargo, apiclient, argoscuola, argoscuolanext
License
Other

Documentation

ArgoScuolaNext API

Programma che utilizza le API di ArgoScuolaNext per gestire e vedere le tue informazioni.

ArgoScuolaNext APIs in Python

ArgoScuolaNext APIs in Go

English description of the client

Tabella dei contenuti

Installazione

Puoi installare facilmente questo client di ArgoScuolaNext utilizzando Composer:

composer require hearot/argoscuolanext

O, se vuoi aggiornare il modulo:

composer update

Importare le API

Devi usare require_once('vendor/autoload.php') per importare tutto il modulo dalla cartella in cui è situato, ovvero vendor.

Log in

Per fare il login dovrai semplicemente istanziare l'oggetto hearot\ArgoScuolaNext\API(), con $schoolCode (codice della scuola), $username e $password come parametri.

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('SCHOOL-CODE', 'USERNAME', 'PASSWORD');

Attività della giornata

Puoi richiamare la query oggi usando la funzione $session->oggi(). Puoi, non è obbligatorio, settare anche la data.

require_once('vendor/autoload.php');


$session = new \hearot\ArgoScuolaNext\API('SCHOOL-CODE', 'USERNAME', 'PASSWORD');
print($session->oggi());

Usando una data diversa (yyyy-mm-dd):

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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().

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('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 fare unset($session)

require_once('vendor/autoload.php');

$session = new \hearot\ArgoScuolaNext\API('SCHOOL-CODE', 'USERNAME', 'PASSWORD');
unset($session);