1. Help Center
  2. Developer
  3. Interfaccia (API) per gli annunci di lavoro

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"}]
  }
]
Aggiornato il 15/03/2024
Questo articolo è stato utile?

Articoli correlati

Non riesce a trovare la risposta che sta cercando?
Nessun problema! Il nostro team di supporto sarà felice di aiutarti.
Support-Team kontaktieren