Interfaccia (API) per interrogare i dati dei rapporti di lavoro

I rapporti di lavoro salvati ad onboard possono essere interrogati tramite un’interfaccia JSON.

Endpoint API

L’endpoint è raggiungibile tramite i seguenti URL:

https://<azienda>.onboard.org/exports/v2/employee_jobs.json

Header

• API-KEY: Obbligatorio per l’autorizzazione. Riceverete la chiave API dal nostro team di support su richiesta.

Parametri

• page: Pagina visualizzata. Inizia da 1.

Esempio:

https://<azienda>.onboard.org/it/exports/v2/employee_jobs.json?page=1

Contenuto

L’interfaccia fornisce i seguenti contenuti:

• entries: Informazioni sui dipendenti
• current_page: Pagina attuale
• per_page: Voci visualizzate per pagina
• total_entries: Numero totale di voci

Le informazioni sul dipendente contengono i dati anagrafici e tutte le informazioni sul rapporto di lavoro:

• id: ID del rapporto di lavoro
• employee_id: ID del dipendente
• from: Iniziare nel formato AAAA-MM-GG
• to: Fine nel formato AAAA-MM-GG. Se non viene indicato alcun termine (zero), l’impiego è a tempo indeterminato.
• name: Denominazione del rapporto di lavoro
• notes: Commento
• location_id: ID della sede
• department_id: ID del dipartimento
• job_type: Tipo di contratto. Valori possibili:
  • unknown: sconosciuto / non impostato
  • unlimited: indeterminato
  • limited: determinato
  • limited_replacement: determinato per sostituzione
  • freelancer: Libero professionista
  • on_demand: a chiamata
  • job_sharing: condivisione del lavoro(job sharing)
  • home: a domicilio
  • coordinated: collaborazione continua e coordinata
  • internship: tirocinio
  • social: attività/lavoro di utilità sociale
  • scholarship: borse di studio e altre esperienze lavorative
  • agency: contratto con l’agenzia
  • seasonal: contratto stagionale
  • apprenticeship: apprendistato tradizionale
  • apprenticeship_specialized: Apprendistato di specializzazione professionale
  • apprenticeship_research: Insegnamento e ricerca nell’ambito dell’istruzione professionale superiore
• time_type: Tempo pieno/tempo parziale. Valori possibili:
  • unknown: sconosciuto / non impostato
  • full_time: A tempo pieno
  • horizontal_part_time: tempo parziale orizzontale
  • vertical_part_time: tempo parziale verticale
  • mixed_part_time: tempo parziale misto
• time_table: orario (testo)
• classification: Classificazione
• time_hours: Ore settimanali
• time_percentage: Percentuale di tempo di lavoro

L’interfaccia può contenere informazioni aggiuntive o adattate (a seconda dei campi utilizzati dal cliente).

Esempio di risposta dell’interfaccia:

{
   "entries":[
      {
         "id": 3,
         "employee_id: "RGb11O42",
         "from": "2023-01-15",
         "to": "2023-06-15",
         "job_type":"unlimited",
         "location_id":77,
         "department_id":9,
         "time_type": "full_time",
         "time_table": "lu-ve 8-16",
         "classification": "AB-1",
         "time_hours": 37.5,
         "time_percentage": 100
      }
   ],
   "current_page":1,
   "per_page":30,
   "total_entries":1
}