karriere.connect

Allgemein

API-Key (Schlüssel)

Der API-Key ist ein Hash-Wert der an eine Domain gebunden ist. Der API-Key muß bei jeder Anfrage als Parameter "key" mitgegeben werden. Mit jedem Schlüssel sind pro Stunde nur 500 Anfragen möglich.

Beispiel	/api/job/list?key=72cd0cf25e9bc3fe5a62cdb1e015ee4c&type=xml

Datentypen

Das karriere.at API unterstützt derzeit fünf Datentypen: JSON, PHP (serialisiert), XML, RSS, ATOM. Die Auswahl des Datentyps erfolgt über den Parameter "type". Wenn kein type-Parameter vorhanden ist wird automatisch JSON zurückgegeben.

Beispiele	/api/job/list?type=xml /api/job/list?type=rss

Seiten

Auflistungen wie Job- oder Firmen-Liste werden in Seiten unterteilt. Mit dem Parameter "page" kann man die aufzurufende Seite auswählen. In den Rückgabe-Daten findet man im Feld "maxPage" die Anzahl der Seiten.

Beispiele	/api/job/list?type=xml /api/job/list?type=xml&page=2

APIs (Schnittstellen)

Jobdetails

Url	/api/job/detail
Parameter	id: erforderlich int Job-ID
Beispiele	/api/job/detail?id=136 /api/job/detail?id=136&type=json

Jobliste/Suche

Url	/api/job/list
Parameter	keyword optional string, mehrere Angaben durch Komma separiert location optional string, mehrere Angaben durch Komma separiert company optional int, Firmen-ID jobfield optional branch optional employment optional level optional date optional page optional int
Beispiele	/api/job/list /api/job/list?keyword=PHP,MySql,Linux&location=Wien /api/job/list?company=136

---

Firmendetails

Url	/api/company/detail
Parameter	id: erforderlich int Firmen-ID
Beispiele	/api/company/detail?id=136 /api/company/detail?id=136&type=json

Firmenliste/Suche

Url	/api/company/list
Parameter	query: optional string Suchbegriff country: optional string/int Land als String oder ID (siehe Info-API), mehrere Angaben durch Komma separiert state: optional string/int Bundesland als String oder ID (siehe Info-API), mehrere Angaben durch Komma separiert location: optional string Stadt/Ort als String branch: optional int Branche als String oder ID (siehe Info-API), mehrere Angaben durch Komma separiert page: optional int Seite
Beispiele	/api/company/list?query=Microsoft /api/company/list?country=Österreich&state=Oberösterreich /api/company/list?location=Linz&branch=4028 /api/company/list?page=2

---

Artikelliste

Url	/api/content/list
Parameter	category: optional int Kategorie-ID(s) durch Beistrich getrennt page: optional int
Beispiele	/api/content/list /api/content/list?category=18,24

Artikelkategorien

Url	/api/content/category
Parameter	parent: optional int Unterkategorien von parent anzeigen
Beispiele	/api/content/category /api/content/category?parent=10

Artikeldetails

Url	/api/content/detail
Parameter	id: obligat int artikel ID
Beispiele	/api/content/detail?id=488&type=xml

---

Infos

Urls	/api/info/jobfield /api/info/level /api/info/employment /api/info/country /api/info/branch
Parameter	parent: für jobfield/country
Beispiele	/api/info/branch /api/info/jobfield?parent=2172&type=xml /api/info/country?parent=Österreich

---

Eigene Anzeigen auflisten

Url	/api/advert/list
Parameter	status: optional string "all", "active", "inactive" oder "draft"
Beispiele	/api/advert/list/ /api/advert/list/status=active /api/advert/list (Status via POST)

Eigene Anzeigendetails

Url	/api/advert/detail
Parameter	id: int Anzeigen-ID
Beispiele	/api/advert/detail/?id=123456 /api/advert/list (id via POST)

Eigene Anzeige erstellen/speichern

Url	/api/advert/save
Parameter (POST)	id: optional int Anzeigen-ID title: string Titel der Stelle location: string Ort der Stelle states: array int Bundesland-ID(s) (siehe /api/info/country) countries: array int Land-ID(s) (siehe /api/info/country) jobfields: array int Berufsfeld-ID(s) (siehe /api/info/jobfield) employmentTypes: array int Anstallungsart-ID(s) (siehe /api/info/employment) jobLevel: int Positionsebene-ID (siehe /api/info/level) keywords: optional array string Stichworte referenceCode: optional string Referenznummer template: optional int Template-ID (siehe /api/advert/templates) templateContent: optional array string Inhalt der Template-Felder (falls template angegeben wurde) htmlContent: optional string HTML-Code der Anzeige (falls kein template verwendet wird)
Beispiele	/api/advert/save (Parameter via POST)

Eigene Anzeige aktivieren

Url	/api/advert/activate
Parameter	id: int Anzeigen-ID
Beispiele	/api/advert/activate/?id=123456 /api/advert/activate (id via POST)

Eigene Anzeige deaktivieren

Url	/api/advert/deactivate
Parameter	id: int Anzeigen-ID
Beispiele	/api/advert/deactivate/?id=123456 /api/advert/deactivate (id via POST)

Verfügbare Tempates

Url	/api/advert/templates
Parameter	-
Beispiele	/api/advert/templates