Vai al contenuto principale

Come possiamo aiutarti?

Indietro

5. API pubblica di Personio 

Questo articolo fornisce una panoramica delle API pubbliche di Personio, delle funzioni degli endpoint API di Personio e dei webhook.

Esplora l'API pubblica

Le API consentono lo scambio di dati tra Personio e un altro servizio o strumento. Ti permettono di collegare Personio ai database o di effettuare l'integrazione con provider di terze parti nel Marketplace di Personio. Queste API offrono diversi endpoint per recuperare e modificare i dati dal tuo account Personio.

Questo elenco offre una panoramica delle funzionalità delle API pubbliche di Personio. Per maggiori informazioni, vai all'Hub per sviluppatori.

API Funzionalità
API per i dipendenti
  • Recuperare i dati dei dipendenti da Personio (compreso il saldo delle assenze).
  • Creare nuovi progetti in Personio.
  • Aggiornare i dati dei dipendente in Personio.

Visita l'Hub per sviluppatori per saperne di più sugli attributi di sistema supportati per creare e aggiornare.
API delle presenze
  • Recuperare i dati sulle presenze da Personio (compresi i dettagli del progetto).
  • Creare nuove presenze in Personio (con ora di inizio e di fine o solo con ora di inizio).
  • Aggiornare le presenze in Personio.
  • Eliminare le presenze in Personio.
API dei progetti di presenza
  • Recuperare i dati sulle presenze da Personio (compresi i dettagli del progetto).
  • Creare nuove presenze in Personio (con ora di inizio e di fine o solo con ora di inizio).
  • Aggiornare le presenze in Personio.
  • Eliminare le presenze in Personio.
API delle assenze
  • Recuperare i dati sulle assenze da Personio (disponibili per le assenze registrate in ore e in giorni).
  • Creare nuove assenze su Personio (disponibile per le assenze registrate in ore e in giorni).
  • Eliminare le assenze su Personio (disponibile per le assenze registrate in ore e in giorni).
API dei documenti
  • Recuperare le categorie e i metadati dei documenti da Personio.
  • Scaricare i file dei documenti da Personio.
  • Inviare un documento a un profilo dipendente di Personio.
  • Aggiornare i metadati dei documenti in Personio.
  • Aggiornare i documenti da Personio.
API dei report personalizzati
  • Recuperare un elenco di tutti i report personalizzati esistenti nell'account Personio
  • Recuperare un elenco di tutte le colonne esistenti della tabella del report.
  • Recuperare i dati di un particolare report personalizzato in formato JSON.

L'API dei report personalizzati consente di unire i dati di Personio con altri set di dati o di archiviarli in un data warehouse per ulteriori elaborazioni. Non può però creare o modificare report personalizzati.
API di compensazione
  • Recuperare i valori e i tipi di compensazione da Personio.
  • Pubblicare i valori e i tipi di compensazione da Personio.
  • Creare nuovi valori e tipi di retribuzione in Personio (non possibile per il salario base).

Credenziali API

Scopri di più su come generare e gestire le credenziali API.

Esplora i webhook

I webhook sono una parte specifica delle API pubbliche di Personio. Consentono di inviare informazioni da Personio alla tua applicazione o al database ogni volta che si verifica un determinato evento. Maggiori informazioni nel nostro Hub per sviluppatori.

Personio fornisce webhook per i seguenti eventi:

  • person.created: Quando il profilo di un dipendente viene creato in Personio.
  • person.deleted: Quando il profilo di un dipendente viene eliminato in Personio.
  • person.updated: Quando alcune parti del profilo del dipendente vengono aggiornate.
  • employment.updated: Quando alcune parti del profilo dipendente relative all'impiego vengono aggiornate.

Documentazione tecnica

Visita il nostro Hub per sviluppatori per ulteriori informazioni sulle API pubbliche di Personio. Contiene tutorial tecnici, informazioni sugli endpoint e i dati precisi trasferiti.

Il nuovo endpoint di autenticazione dell'API pubblica di Personio, i webhook, gli endpoint API dei dati di compensazione, gli endpoint API di alcuni documenti e gli endpoint API nella fase di test sono documentati nell'Hub per sviluppatori v2.

 

 

Aiutaci a migliorare. Questa pagina è utile?