Home

Schnittstelle zum Transfer von Jobs

Durch eine Elektronische Schnittstelle (auch Job-Feed, Web-Dienst oder API genannt) kann Ihr System seiner Umgebung und METAJob mitteilen, welche Jobangebote auf Ihrem Internetauftritt zu finden sind.

Technisch wird die Schnittstelle durch ein REST-API implementiert, welches das Protokoll HTTP/S (GET) verwendet und die Jobangebote im Format XML oder JSON retourniert. Das Erstellen einer derartigen Schnittstelle erfordert IT-Know-How. Bitte konsultieren Sie dazu auch Ihre IT-Abteilung bzw. Ihren Webmaster.

Nach der Einrichtung der Schnittstelle durch Ihre IT teilen Sie METAJob die Internetadresse (URI) der Schnittstelle mit. METAJob wird diese dann periodisch abrufen und die darin enthaltenen Jobangebote auf METAJob übernehmen.

Job-Attribute

Für jedes Jobangebot benötigt METAJob die im Folgenden angeführten Informationseinheiten (Felder/Attribute). Attribute, welche mit "Muss" markiert sind, müssen vorhanden sein.

Attribut	Beschreibung	Existenz
id	ID/Surrogate/Identificator. Identifiziert ein Jobangebot. Bleibt unverändert, auch wenn sich Daten des Jobangebots selber verändern. Wird verwendet, um Neuzugänge/Löschungen von Jobangeboten zu erkennen. Falls nicht vorhanden, wird url als Id verwendet.	Empfohlen
title	Jobtitel.	Muss
location oder locations	Ein oder mehrere (durch Komma getrennte) Einsatzorte oder geografische Regionen. Sollten die verwendeten Namen nicht eindeutig sein, muss dem Ort eine Postleitzahl vorangestellt sein. Beispielhaftes XML: <location>2620 Neunkirchen, 2630 Ternitz, 2700 Wr. Neustadt</location> Alternativ können die Einsatzorte ausmodelliert werden, z.B. in XML als: <locations> <location> <zip>2620</zip> <city>Neunkirchen</city> <counry>AT</country> </location> <location> ... </location> ... </locations>	Muss
url	Die Internetadresse des Jobinserats.	Muss
company	Der Name des Unternehmens, welches die Stelle besetzt.	Muss
published	Datum der Veröffentlichung des Jobinserats im Format YYYY-MM-DD, z.B. 2015-12-31.	Muss
description	Nutztext des Jobinserats im HTML-Format. METAJob verwendet den Inseratentext zur Extraktion von relevanten Informationen, wie z.B. Gehalt, Arbeitszeit, Skills, Aufgabenbeschreibung usw. Bitte übergeben Sie daher in 'description' den kompletten Inseratentext. Eine gekürzte Fassung ist nicht zulässig.	Muss
logourl	Internetadresse einer Bilddatei des Unternehmenslogos. Unterstützte Formate: jpg, png, svg. Das Bild wird links neben der Jobbeschreibung in den METAJob-Suchergebnissen angezeigt.	Muss für Jobbörsen
segment	Frei wählbarer Name des Preissegments, dem der Job angehört. Damit ist es möglich, Jobs auf Preissegmente aufzuteilen. Den Preissegmenten können dann im Admin-UI unterschiedliche CPCs(Klickpreise) zugeordnet werden. Nur relevant für METAClick-Teilnehmer, die ihre Jobs mit unterschiedlichen CPCs schalten wollen.	Optional
cpc	Job-spezifischer CPC in EUR, Beispiel: 0,25. Muss entweder bei allen Jobangeboten vorhanden sein, oder bei keinem.	Optional

Falls Sie eine bestehende Schnittstelle (wieder-)verwenden, können die Attribute auch andere Namen haben, wie z.B. 'jobtitel' anstelle von 'title'.

XML

Das momentan am häufigsten verwendete Format ist XML. Eine Schnittstelle im XML-Format liefert Job-Infos in folgender Form:

<?xml version="1.0" encoding="UTF-8"?>
<jobs>
<job>
   ... siehe unten ...
</job>
<job>
   ... siehe unten ...
</job>
<job>
   ... siehe unten ...
</job>
</jobs>

Jeder Job im XML wird beispielhaft wie folgt notiert:

...
<job>
  <title>Web-Entwickler (m/w)</title>
  <location>Wien, 8020 Graz</location>
  <url>http://www.xyz.com/job/127</url>
  <company>XYZ-GmbH</company>
  <published>2013-12-01</published>
  <segment>A</segment>
  <description><![CDATA[
<p>Die XYZ-GmbH ist Marktführer im Bereich ...</p>
<p>Für unsere Niederlassungen in Wien und Graz suchen wir zum sofortigen Eintritt eine(n):</p>
<h1>Web-Entwickler (m/w)</h1>
<p>In dieser Position entwickeln Sie in einem motivierten Team ...</p>
...
<p>Bitte senden Sie Ihre aussagekräftigen Bewerbungsunterlagen an ...</p>
  ]]></description>
</job>
...

Die häufigsten XML-Fehler

Falls Sie eine XML-Schnittstelle erstellen, überprüfen Sie bitte folgende Punkte:

Escaping

Manche Zeichen haben reservierte Bedeutung in XML und müssen daher in den Daten durch ein XML-Entity ersetzt werden:

Zeichen	XML-Entity
`"`	`"`
`<`	`<`
`>`	`>`
`&`	`&`
`'`	`'`

Richtig ist:

  <title>Entwickler &amp; Designer (m/w)</title>

falsch hingegen ist:

  <title>Entwickler & Designer (m/w)</title>

Escaping in CDATAs

Falls Sie Ihre Daten in CDATAs einhüllen, dürfen sie nicht escaped werden. Richtig ist:

  <title><![CDATA[Entwickler & Designer (m/w)]]></title>

falsch hingegen ist:

  <title><![CDATA[Entwickler &amp; Designer (m/w)]]></title>

JSON

Alternativ zu XML können die Jobangebote in JSON (JavaScript Object Notation) kodiert werden, Beispiel:

  [
    {
      "title": "Web-Entwickler (m/w)",
      "location": "Wien, 8020 Graz",
      "url": "http://www.xyz.com/job/127",
      "company": "XYZ-GmbH",
      "published": "2013-12-01",
      "segment": "A",
      "description": "<p>Die XYZ-GmbH ..."
    },
    {
      "title": "...",
      ...
    },
    ...
  ]

JSON ist etwas einfacher und kompakter als XML und hat sehr guten Tool-Support für die wichtigsten Programmiersprachen.