Zum Hauptinhalt gehen

Job-Feed Integration

  • Aktualisiert
Verfügbar im Paket
Prescreen Go Core Pro Ultimate
Verfügbar im Paket
Gratis Core Pro
Verfügbar im Paket
Core Pro
Verfügbar im Paket
Core Pro Ultimate
Verfügbar im Paket
Essential Core Pro Ultimate
Verfügbar im Paket
Core Pro Ultimate
Verfügbar im Paket
360°

Mit dem Job-Feed können Sie alle veröffentlichten Jobs Ihres Kontos abrufen. Der folgende Leitfaden erläutert die verfügbaren Parameter und die Struktur der zurückgegebenen Daten.

Verfügbare Formate

Folgende Formate sind verfügbar: JSON, XML, XML-CDATA, HTML

Die Abfrage

Die Abfrage erfolgt über: https://subdomain.onlyfy.io/job/list/{handle}?format={format}

 

[tipp]

NEU! Abfrage inklusive HTML der Job-Vorlagen

[/tipp]

 

Subdomain: Jedes Konto hat eine einzigartige Subdomain.

Der Parameter

Parameter Werte Default Beschreibung
handle*     Jedes Konto hat ein eindeutiges md5-Handle.
format* json,xml    
lang browser, de, en, hu, fr browser Bestimmt die Sprache der Widget-Schnittstelle. Bei der Einstellung "browser" wird die Sprache der aktuellen Anfrage-Sitzung verwendet.
sorting_mode alphabetic, date alphabetic  
sorting_dir ASC, DESC ASC  
start_display 0, 1, .... 0  
max_results 1, 2, ..., 250 20  
country_code de, at, uk, ...    
instance_id     Instanz-ID: Ein Konto kann mehrere Subinstanzen haben (z.B. Subunternehmen, Abteilungen, usw.). Bitte kontaktieren Sie Ihren Account Manager für weitere Einzelheiten.
team_id     Team ID: Je nach Struktur Ihres Unternehmens kann dies eine Abteilung (z.B. IT, Marketing), ein Standort, usw. sein.
city_id     Jobs aus einer bestimmten Stadt filtern.
industry_id     Jobs aus einer bestimmten Branche filtern.
distance     Filtert anhand der angegebenen city_id Jobs innerhalb eines bestimmten Kilometerradius.
department_id     ID des Arbeitsgebietes (z. B. Sales, IT.)
position_type_id     ID der Art der Position (z. B. Vollzeit, Teilzeit)
seniority_id     ID der Berufserfahrung (z. B. 3, usw.)
cf[]     Array of custom defined field IDs
cfvid[]     Array of custom field value ids (same order as custom fields)
cfv[]     Array of custom field values (same order as custom fields)

* = Pflichtfeld

Beispiel parameter string:

?format=json&sorting_mode=alphabetic&sorting_dir=ASC&start_display=10&max_results=10&country_code=at&city_id=5241&department_id=21&position_type_id=1&cf[]=138&cfv[]=example-value

Die Antwort

1. Beispiel: JSON / single job, simple job description

{
	"company":"onlyfy",
	"totalResults":1,
	"currentStartDisplay":0,
	"jobs":[{
		"title":"Sales Manager",
		"handle":"rafsb85qgao0kokgc4skwwgswgkwg08",
		"showUrl":"https:\/\/subdomain.onlyfy.io\/candidate\/job\/show\/TEST-HANDLE\/rafsb85qgao0kokgc4skwwgswgkwg08",
		"template": {"id": 10,	"name": "Sales Manager"},
		"bannerUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/jobs\/1.jpg",
		"bannerFooterUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/job_banner_footer\/1.jpg",
		"department":{"id":21,"title":"Sales"},
		"city":{"id":5241,"title":"Vienna","country":"Austria","countryCode":"AT"},
		"positionType":{"id":1,"title":"Full-time"},
		"seniority":{"id":3,"title": "Berufserfahren"},
		"industry_id": 25,
		"startOfWork": "2016-01-01",
		"headcount": 1,
		"instance":{"id":1,"name":"External"},
		"team":{"id":1,"name":"Sales Vienna HQ"},
		"custom_data_fields": [{"id": 29,"name": "Department","form_label": "Department","value": "Sales"}],
		"description":"Example job description."
	}]
}

2. Beispiel: JSON / single job, multiple content blocks (job descriptions)

{
	"company":"onlyfy",
	"totalResults":1,
	"currentStartDisplay":0,
	"jobs":[{
		"title":"Software Developer",
		"handle":"5q6vfzi2ixhc2sdlrhfm8irsb0yczzj",
		"showUrl":"https:\/\/subdomain.onlyfy.io\/candidate\/job\/show\/TEST-HANDLE\/5q6vfzi2ixhc2sdlrhfm8irsb0yczzj",
		"template": {"id": 11,	"name": "Developer"},
		"bannerUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/jobs\/1.jpg",
		"bannerFooterUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/job_banner_footer\/1.jpg",
		"department":{"id":9,"title":"IT"},
		"city":{"id":5241,"title":"Vienna","country":"Austria","countryCode":"AT"},
		"positionType":{"id":1,"title":"Full-time"},
		"seniority":{"id":3,"title": "Berufserfahren"},
		"industry_id": 25,
		"startOfWork": "2016-01-01",
		"headcount": 1,
		"instance":{"id":1,"name":"External"},
		"team":{"id":1,"name":"Sales Vienna HQ"},
		"custom_data_fields": [{"id": 29,"name": "Department","form_label": "Department","value": "Development"}],
		"description":{"job_content_1":"Intro text.", "job_content_2":"Example content."}
	}]

3. Beispiel: XML / multiple jobs

<data>
	<company>onlyfy</company>
	<totalresults>2</totalresults>
	<currentstartdisplay>0</currentstartdisplay>
	<jobs>
		<job>
			<title>Sales Manager</title>
			<handle>rafsb85qgao0kokgc4skwwgswgkwg08</handle>
			<showurl>https://subdomain.onlyfy.io/candidate/job/show/TEST-HANDLE/rafsb85qgao0kokgc4skwwgswgkwg08</showurl>
			<template><id>10</id><name>Sales Manager</name></template>
			<bannerUrl>https://subdomain.onlyfy.io/uploads/company/jobs/1.jpg</bannerUrl>
			<bannerFooterUrl>https://subdomain.onlyfy.io/uploads/company/job_banner_footer/1.jpg</bannerFooterUrl>
			<department><id>21</id><title>Sales</title></department>
			<city><id>5241</id><title>Vienna</title><country>Austria</country><countryCode>AT</countryCode></city>
			<positiontype><id>1</id><title>Full-time</title></positiontype>
			<seniority><id>3</id><title>Berufserfahren</title></seniority>
			<industry_id>25</industry_id>
			<startOfWork>2015-09-14</startOfWork>
			<headcount>1</headcount>
			<instance><id>1</id><name>External</name></instance>
			<team><id>1</id><name>Sales Vienna HQ</name></instance>
			<custom_data_fields><custom_data_field><id>29</id><name>Department</name><form_label>Department</form_label><value>Sales</value></custom_data_field></custom_data_fields>
			<description><job_content_1>Intro text.</job_content_1><job_content_2>Example content.</job_content_2></description>
		</job>
		<job>
			<title>Software Developer</title>
			<handle>5q6vfzi2ixhc2sdlrhfm8irsb0yczzj</handle>
			<showurl>https://subdomain.onlyfy.io/candidate/job/show/TEST-HANDLE/5q6vfzi2ixhc2sdlrhfm8irsb0yczzj</showurl>
			<template><id>11</id><name>Developer</name></template>
			<bannerUrl>https://subdomain.onlyfy.io/uploads/company/jobs/1.jpg</bannerUrl>
			<bannerFooterUrl>https://subdomain.onlyfy.io/uploads/company/job_banner_footer/1.jpg</bannerFooterUrl>
			<department><id>9</id><title>IT</title></department>
			<city><id>5241</id><title>Vienna</title><country>Austria</country><countryCode>AT</countryCode></city>
			<positiontype><id>1</id><title>Full-time</title></positiontype>
			<seniority><id>3</id><title>Berufserfahren</title></seniority>
			<startOfWork>2015-09-14</startOfWork>
			<headcount>1</headcount>
			<instance><id>1</id><name>External</name></instance>
			<team><id>1</id><name>Sales Vienna HQ</name></team>
			<custom_data_fields><custom_data_field><id>29</id><name>Department</name><form_label>Department</form_label><value>Development</value></custom_data_field></custom_data_fields>
			<description><job_content_1>Intro text.</job_content_1></description>
		</job>
	</jobs>
</data>

4. Beispiel: XML-CDATA / multiple jobs

<data>
	<company><![CDATA[onlyfy]]></company>
	<totalresults><![CDATA[2]]></totalresults>
	<currentstartdisplay><![CDATA[0]]></currentstartdisplay>
	<jobs>
		<job>
			<title><![CDATA[Sales Manager]]></title>
			<handle><![CDATA[rafsb85qgao0kokgc4skwwgswgkwg08]]></handle>
			<showurl><![CDATA[https://subdomain.onlyfy.io/candidate/job/show/TEST-HANDLE/rafsb85qgao0kokgc4skwwgswgkwg08]]></showurl>
			<template><id><![CDATA[10]]></id><name><![CDATA[Sales Manager]]></name></template>
			<bannerUrl><![CDATA[https://subdomain.onlyfy.io/uploads/company/jobs/1.jpg]]></bannerUrl>
			<bannerFooterUrl><![CDATA[https://subdomain.onlyfy.io/uploads/company/job_banner_footer/1.jpg]]></bannerFooterUrl>
			<department><id><![CDATA[21]]></id><title><![CDATA[Sales]]></title></department>
			<city><id><![CDATA[5241]]></id><title><![CDATA[Vienna]]></title><country><![CDATA[Austria]]></country><countryCode><![CDATA[AT]]></countryCode></city>
			<positiontype><id><![CDATA[1]]></id><title><![CDATA[Full-time]]></title></positiontype>
			<seniority><id><![CDATA[3]]></id><title><![CDATA[Berufserfahren]]></title></seniority>
			<industry_id><![CDATA[25]]></industry_id>
			<startOfWork><![CDATA[2015-09-14]]></startOfWork>
			<headcount><![CDATA[1]]></headcount>
			<instance><id><![CDATA[1]]></id><name><![CDATA[External]]></name></instance>
			<team><id><![CDATA[1]]></id><name><![CDATA[Sales-Vienna HQ]]></name></team>
			<custom_data_fields><custom_data_field><id><![CDATA[29]]></id><name><![CDATA[Department]]></name><form_label><![CDATA[Department]]></form_label>
				<value><![CDATA[Sales]]></value></custom_data_field></custom_data_fields>
			<description><job_content_1><![CDATA[Intro text.]]></job_content_1><job_content_2><![CDATA[Example content]]></job_content_2></description>
		</job>
		<job>
			<title><![CDATA[Software Developer]]></title>
			<handle><![CDATA[5q6vfzi2ixhc2sdlrhfm8irsb0yczzj]]></handle>
			<showurl><![CDATA[https://subdomain.onlyfy.io/candidate/job/show/TEST-HANDLE/5q6vfzi2ixhc2sdlrhfm8irsb0yczzj]]></showurl>
			<template><id><![CDATA[11]]></id><name><![CDATA[Developer]]></name></template>
			<bannerUrl><![CDATA[https://subdomain.onlyfy.io/uploads/company/jobs/1.jpg]]></bannerUrl>
			<bannerFooterUrl><![CDATA[https://subdomain.onlyfy.io/uploads/company/job_banner_footer/1.jpg]]></bannerFooterUrl>
			<department><id><![CDATA[9]]></id><title><![CDATA[IT]]></title></department>
			<city><id><![CDATA[5241]]></id><title><![CDATA[Vienna]]></title><country><![CDATA[Austria]]></country><countryCode><![CDATA[AT]]></countryCode></city>
			<positiontype><id><![CDATA[1]]></id><title><![CDATA[Full-time]]></title></positiontype>
			<seniority><id><![CDATA[3]]></id><title><![CDATA[Berufserfahren]]></title></seniority>
			<industry_id><![CDATA[25]]></industry_id>
			<startOfWork><![CDATA[2015-09-14]]></startOfWork>
			<headcount><![CDATA[1]]></headcount>
			<instance><id><![CDATA[1]]></id><name><![CDATA[External]]></name></instance>
			<team><id><![CDATA[1]]></id><name><![CDATA[Sales-Vienna HQ]]></name></team>
			<custom_data_fields><custom_data_field><id><![CDATA[29]]></id><name><![CDATA[Department]]></name><form_label><![CDATA[Department]]></form_label>
				<value><![CDATA[Sales]]></value></custom_data_field></custom_data_fields>
			<description><job_content_1><![CDATA[Intro text.]]></job_content_1><job_content_2><![CDATA[Example content]]></job_content_2></description>
		</job>
	</jobs>
</data>

5. Beispiel: HTML

Die Abfrage erfolgt über:

  • https://subdomain.onlyfy.io/job/list/{handle}?format={format}&include_job_ad_html=1
  • https://subdomain.onlyfy.io/job/list/{handle}?include_job_ad_html=1 '
    (dann würde das default format verwendet werden (xml))
{
  "company":"onlyfy",
  "totalResults":1,
  "currentStartDisplay":0,
  "jobs":[{
    "title":"Sales Manager",
    "handle":"rafsb85qgao0kokgc4skwwgswgkwg08",
    "showUrl":"https:\/\/subdomain.onlyfy.io\/candidate\/job\/show\/TEST-HANDLE\/rafsb85qgao0kokgc4skwwgswgkwg08",
    "template": {"id": 10,  "name": "Sales Manager"},
    "bannerUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/jobs\/1.jpg",
    "bannerFooterUrl": "https:\/\/subdomain.onlyfy.io\/uploads\/company\/job_banner_footer\/1.jpg",
    "department":{"id":21,"title":"Sales"},
    "city":{"id":5241,"title":"Vienna","country":"Austria","countryCode":"AT"},
    "positionType":{"id":1,"title":"Full-time"},
    "seniority":{"id":3,"title": "Berufserfahren"},
    "industry_id": 25,
    "startOfWork": "2016-01-01",
    "headcount": 1,
    "instance":{"id":1,"name":"External"},
    "team":{"id":1,"name":"Sales Vienna HQ"},
    "custom_data_fields": [{"id": 29,"name": "Department","form_label": "Department","value": "Sales"}],
    "description":"Example job description.",
 "jobAdHtml": "<html><body>Example job ad html</body></html>
  }]
}

[hint]

Durch das Hinzufügen des HTML im Job-Feed Link können die Ladezeiten des Feeds beeinflusst werden.

[/hint]

War dieser Beitrag hilfreich?

0 von 15 fanden dies hilfreich

Verwandte Beiträge