How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Politecnico di Torino Student API

Student resources of the Polito Students API, split per tag from openapi/_original/. Operated by Politecnico di Torino on app.didattica.polito.it; the contract is authored by the university in TypeSpec and published at github.com/polito/api-spec. Bearer authentication against a PoliTO account is required — the base path returns 403 anonymously.

Politecnico di Torino Student API is one of 20 APIs that Politecnico di Torino publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Students. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 17 operations across 16 paths, and defines 17 schemas. It is described by OpenAPI 3.2.0, at version 0.0.1.

Requests are made against 2 base URLs: https://app.didattica.polito.it/api, https://app.didattica.polito.it/mock/api.

17 operations 16 paths 17 schemas 2 DELETE9 GET2 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.1
Base URL
https://app.didattica.polito.it/api
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Politecnico di Torino Student API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

Paths & Operations 17

Across 16 paths, the API surfaces 17 operations — 2 DELETE, 9 GET, 2 PATCH, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Student 17
GET
/deadlines
List deadlines | Elenca scadenze
StudentNs_getDeadlines 2 params → 200400500
GET
/grades
Retrieve student grades | Recupera i voti dello studente
StudentNs_getStudentGrades → 200400500
GET
/guides
Get guides | Mostra guide
StudentNs_getGuides → 200400500
GET
/me
Retrieve student profile | Recupera il profilo studente
StudentNs_getStudent → 200400500
GET
/messages
List messages | Elenca messaggi
Messages_getMessages → 200400500
DELETE
/messages/{messageId}
Delete a message | Cancella un messaggio
Messages_deleteMessage 1 param → 204400500
PUT
/messages/{messageId}/read
Mark a message as read | Segna un messaggio come letto
Messages_markMessageAsRead 1 param → 204400500
GET
/notifications
List notifications | Elenca notifiche
Notifications_getNotifications → 200400500
GET
/notifications/preferences
Get notification preferences | Ottieni preferenze notifiche
Notifications_getNotificationPreferences → 200400500
PATCH
/notifications/preferences
Update notification preferences | Aggiorna preferenze notifiche
Notifications_updateNotificationPreferences body → 204400500
DELETE
/notifications/{notificationId}
Delete a notification | Cancella una notifica
Notifications_deleteNotification 1 param → 204400500
PUT
/notifications/{notificationId}/read
Mark a notification as read | Segna una notifica come letta
Notifications_markNotificationAsRead 1 param → 204400500
PATCH
/preferences
Update device preferences | Aggiorna preferenze del dispositivo
StudentNs_updateDevicePreferences body → 204400500
GET
/provisional-grades
Retrieve student provisional grades | Recupera le valutazioni provvisorie dello studente
ProvisionalGrades_getStudentProvisionalGrades → 200400500
POST
/provisional-grades/{provisionalGradeId}/accept
Accept provisional grade | Accetta valutazione provvisoria
ProvisionalGrades_acceptProvisionalGrade 1 param → 204400500
POST
/provisional-grades/{provisionalGradeId}/reject
Reject provisional grade | Rifiuta valutazione provvisoria
ProvisionalGrades_rejectProvisionalGrade 1 param → 204400500
GET
/unreadEmails
Retrieve student's unread emails number | Recupera il numero di email non lette dello studente
StudentNs_getUnreadEmailsNumber → 200400500

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are Student (29 properties), ProvisionalGrade (18 properties), ExamGrade (9 properties), Message (7 properties). Each schema is shown below with its type and property counts.

Notification
object
6 properties 5 required
UpdatePreferencesRequest
object
1 property
NotificationPreferences
object
5 properties 5 required
Guide
object
6 properties 6 required
GuideSection
object
2 properties 2 required
ExamGrade
object
9 properties 9 required
EmailBadge
object
1 property 1 required
ProvisionalGrade
object
18 properties 18 required
Message
object
7 properties 7 required
ErrorResponse
object
2 properties
GuideField
object
3 properties 2 required
UpdateNotificationPreferencesRequest
object
1 property
EuropeanStudentCard
object
2 properties 2 required
Student
object
29 properties 29 required
MessageType
string
ProvisionalGradeState
object
3 properties 3 required
Deadline
object
5 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

politecnico-di-torino-student-api-openapi.yml Raw ↑

Other APIs Politecnico di Torino publishes across the network.

PoliTO Students App (mobile backend client)
PoliTO Open Data
Politecnico di Torino Shibboleth Identity Provider (IDEM GARR / eduGAIN)
IRIS PoliTO OAI-PMH Metadata Service (CINECA deployment)
Politecnico di Torino Announcements API
Politecnico di Torino Auth API
Politecnico di Torino Bookings API
Politecnico di Torino Courses API
Politecnico di Torino Esc API
Politecnico di Torino Exams API
Politecnico di Torino Job offers API
Politecnico di Torino Lectures API
Where this information came from

This is an independent, third-party profile of Politecnico di Torino Student API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.