Vai al contenuto principale

Piattaforma developer

Costruisci su InTransparency

Integra dati studenti verificati, ricerca talenti e monitoraggio placement nei tuoi sistemi.

Panoramica API

Endpoint API

InTransparency espone un’API REST in sola lettura su profili studente verificati, aziende e posizioni aperte, sui vocabolari ESCO su cui è costruito il matching e sulla verifica delle credenziali — più watchlist e webhook, così il tuo sistema viene avvisato quando c’è un riscontro invece di interrogare di continuo. Autenticazione con una chiave API legata all’organizzazione.

Cosa ti dà oggi una chiave API

API di consultazione

Leggi profili studente, progetti, valutazioni dei docenti e credenziali, oltre ad aziende e posizioni aperte. Sola lettura: gli studenti si registrano da sé e gli istituti gestiscono i propri dati.

Dati di riferimento

Occupazioni e competenze ESCO, il registro degli algoritmi, i framework di conformità e il glossario: i vocabolari su cui è costruito il matching, così il tuo sistema parla la stessa lingua.

Watchlist

Salva una ricerca ricorrente con la tua chiave e rileggila, invece di ricostruirla a ogni chiamata. Gli avvisi quando nuovi candidati la soddisfano non vengono ancora inviati.

Webhook

Ricevi un POST firmato quando nasce un match per la tua iscrizione, viene emessa una credenziale, un tirocinio viene valutato o uno scambio si conclude. Ogni consegna viene tentata una volta e registrata.

Riferimento webhook & automazione

Cinque eventi firmati, setup copia-incolla per Zapier, Make, n8n o qualunque ricevitore custom. HMAC-SHA256 su ogni consegna.

Apri il riferimento webhook →

Autenticazione

Tutte le richieste API sono autenticate tramite chiavi API. Ogni chiave è associata alla tua organizzazione e può essere configurata con permessi granulari. Le chiavi si gestiscono dalle impostazioni della dashboard.

  1. Genera una chiave API dalla dashboard della tua organizzazione
  2. Includi la chiave nell'header Authorization di ogni richiesta
  3. Usa chiavi separate per ambienti di sviluppo e produzione

In arrivo

Stiamo sviluppando attivamente la piattaforma developer

  • SDK Python e Node.js

    Librerie client ufficiali per un'integrazione più veloce

  • Ambiente sandbox

    Testa la tua integrazione con dati di esempio prima di andare in produzione

  • Documentazione rate limiting

    Limiti di frequenza dettagliati, quote e best practice per utilizzo ad alto volume

Pronto per integrare?

Richiedi l'accesso API e lo configuriamo insieme.