Allgemeines zur XML-Schnittstelle

Die Werte und Funktionsweise orientiert sich an der ReST-API.

Ablauf

Die XML Feeds werden zwischen 07:00 Uhr und 21:00 Uhr stündlich verarbeitet.

Inserate, welche nicht mehr im Feed enthalten sind, werden automatisch beendet.

Metadaten (Kategorien, Anforderungen, Anstellungsart)

Für diese 4 Properties

• categories/category
• requirement
• contracttype
• employmenttype

muss die ReST-API bezüglich der möglichen Werte abgefragt werden

curl --request GET "https://<stellenmarkt>/api/categories/" --header "version: 1"

curl --request GET "https://<stellenmarkt>/api/contracttypes/" --header "version: 1"

curl --request GET "https://<stellenmarkt>/api/employmenttypes/" --header "version: 1" 

curl --request GET "https://<stellenmarkt>/api/requirements/" --header "version: 1" 

Diese Endpunkte liefern (bis auf den /categories Endpunkt) ein JSON Array mit Key/Value Paaren zurück

Beispiel:

[
    {
        "key": "none",
        "value": "ohne stellenspezifische Ausbildung"
    },
    {
        "key": "basiccourses",
        "value": "Basiskurse"
    },
    {
        "key": "basiceducation",
        "value": "Sekundarstufe II"
    },
    {
        "key": "highereducation",
        "value": "Tertiärstufe B"
    },
    {
        "key": "university",
        "value": "Tertiärstufe A"
    }
]

Die XML Schnittstelle erwartet hier immer die Keys.

Erläuterungen zum Upsale

Die Property <upsale> ist optional.

Falls die Property "upsale" mit einem der 3 Child-Elemente (<jobscout />,<autopush /> oder <toplisting />) geliefert wird, führt dies zu einer kostenpflichtigen Buchung des entsprechenden Produktes.

Das Produkt <jobscout /> kann auch ohne Angabe der entsprechenden Metadaten gebucht werden. In diesem Fall werden die für JobScout benötigten Metadaten automatisch auf Basis der Inseratsmetadaten bestimmt.

Hinweis

Bei einer Buchung des Produktes jobscout wird bei jobscout24.ch das Inserat nicht auf Basis des Wertes des <externallink> angezeigt, sondern auf Basis der gelieferten Rohdaten. (<title>, <subtitle>, <description>, etc.)

<upsale>
	<jobscout>
		<category></category>
		<subcategories>
			<subcategory></subcategory>
		</subcategories>
		<contracttype></contracttype>
		<postiontype></postiontype>
		<region></region>
	</jobscout>
	<autopush />
	<toplisting />
</upsale>

Hinweis zu Porträts/Profilen

Falls der Kunde genau ein erfasstes Porträt hat, wird dies dem Inserat automatisch zugewiesen, wenn die entsprechende Property <profileidentitynumber> nicht leer geliefert wird.