Interfaccia (API) per gli annunci di lavoro

Gli annunci di lavoro pubblicati da onboard sono disponibili attraverso un’interfaccia JSON.

API Endpoint

L’endpoint può essere raggiunto tramite il seguente indirizzo:

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

Inoltre, esistono endpoint separati per ogni lingua. La lingua può essere specificata nel formato ISO 639-1 (ad esempio, “de”, “it” o “en”). L’endpoint è raggiungibile tramite i seguenti indirizzi:

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

https://<azienda>.onboard.org/de/exports/v2/jobs.json
https://<azienda>.onboard.org/it/exports/v2/jobs.json
https://<azienda>.onboard.org/en/exports/v2/jobs.json
...

È anche possibile interrogare singoli annunci di lavoro:

https://<azienda>.onboard.org/exports/v2/jobs/<Job-ID>.json

Parametri

• campaign: Campagna attraverso la quale devono essere filtrati gli annunci di lavoro
• publication_channel: Canale attraverso il quale devono essere filtrati gli annunci di lavoro
• show_on_career_site: Mostra solo gli annunci di lavoro visualizzati sul sito web. Valori amessi sono true o false.
• location_id: Visualizza gli annunci di lavoro solo da questa sede
• location_ids[]: Visualizza gli annunci di lavoro solo da queste sedi
• department_id: Visualizza gli annunci di lavoro solo da questo reparto
• department_ids[]: Visualizza gli annunci di lavoro solo da questo dipartimento
• subtree_department_id: Visualizza gli annunci di lavoro di questo dipartimento e i reparti subordinati.

Esempio:

https://<azienda>.onboard.org/de/exports/v2/jobs.json?publication_channel=292hAjyX&show_on_career_site=true

L’endpoint API esatto con i parametri di tracciamento è disponibile su richiesta presso il nostro support-team.

Contenuto

Alcuni campi sono traducibili (ad esempio “title”). Se nell’URL non è specificata alcuna lingua, vengono restituite tutte le traduzioni possibili (ad esempio, “title_it”, “title_en”). Se viene specificata una lingua, viene restituita solo la lingua selezionata.

L’interfaccia contiene tutte le informazioni necessarie per l’annuncio di lavoro:

• id: ID unico
• languages: lingue in cui è stato pubblicato l’annuncio di lavoro
• published_at: data di pubblicazione
• url: link all’annuncio di lavoro
• form_url: link al modulo di candidatura
• image_url: immagine di sfondo dell’annuncio di lavoro
• title: titolo
• description: descrizione (può contenere codice HTML)
• business: informazioni sull’azienda
• locations: sedi. Per dettagli vedi qui.
• departments: dipartimenti. Per dettagli vedi qui.
• types: Tipi di rapporto di lavoro. Valori possibili:
  full_time: tempo pieno
  part_time: part-time
  remote: remote (Home Office)
  internship: tirocinio
  apprenticeship: apprendistato
  unlimited: indeterminato
  limited: determinato
  minor: marginale
• salary_type: Stipendio. Valori possibili:
  none: non specificato
  value: valore
  range: fascia di stipendio
  text: testo
• salary_value: importo stipendio, se salary_type é impostato su value
• salary_min_value: importo stipendio minimo, se salary_type è impostato su range 
• salary_max_value: importo stipendio massimo, se salary_type è impostato su range 
• salary_value_type: Tipo stipendio: Valori possibili:
  gross: lordo
  net: netto
• formatted_salary: informazioni sullo stipendio formattato come testo (se disponibile)
• entry_date_type: data d’inizio. Valori possibili:
  none: non specificato
  immediately: a partire da ora
  arrangement: da concordare
  date: con data
• entry_date: data d’inizio, se entry_date_type è impostato su date
• background_image_url: immagine di sfondo dell’annuncio di lavoro
• contact_person: nome della persona di contatto (facoltativo)
• contact_phone: numero di telefono della persona di contatto (facoltativo)
• contact_email: contatto e-mail (facoltativo)
• reference: numero di riferimento dell’annuncio di lavoro (facoltativo)

Esempio di risposta dell’interfaccia:

[
  {
    "id": "KeN07w4q",
    "languages": ["de", "it"],
    "types": ["full_time"]
    "published_at": "2021-02-26",
    "url": "https://demo.onboard.org/de/jobs/KeN07w4q",
    "form_url": "https://demo.onboard.org/jobs/KeN07w4q/form?show_logo=true",
    "title": "consulente (m/w/d)",
    "description": "\u003ch3\u003eDescrizione\u003c/h3\u003e\n\u003cp style=\"text-align: justify;\"\u003eTesto: Lorem ipsum dolor sit amet.\u003c/p\u003e",
    "business": { "id": "XQmwJ3e9", "subdomain": "demo", "title_de": "Looptec New Media", "title_it": "Looptec New Media" },
    "locations": [{"id": 677, "name_de": "Bozen", "name_it": "Bolzano" }],
    "departments": [{"id": 1276, "name_de": "Produktion", "name_it": "Produzione"}]
  }
]