Schnittstelle für Inserate
Über die Gastro-Plattform haben Sie die Möglichkeit, eigene Inserate auch automatisiert via Schnittstelle zu publizieren. Hierfür erstellen Sie auf Ihrer Seite einen öffentlich abrufbaren JSON-Feed, welchen wir dann an die Plattform anbinden. Die Verwendung der Schnittstelle ist für Sie kostenlos, es fallen lediglich die normalen Gebühren für die Inserate-Einstellung an.
Empfohlenes Vorgehen
Wir empfehlen für die Entwicklung folgendes Vorgehen:
- Sie programmieren den Feed auf Ihrer Seite
- Danach senden Sie unserer Technikabteilung den Link zum Feed (Kontaktdaten siehe rechts in der Box)
- Unsere Technikabteilung kontrolliert den Feed, und schaltet diesen wenn alles ok ist auf
- Laden Sie genügend Guthaben auf Ihrem Konto auf, damit die Inserate automatisch geschaltet werden können
Aufbau des JSON Feeds
Den Feed, den Sie zur Verfügung stellen, listet in einem Array alle Inserate auf. Dabei müssen Sie die drei Properties inserate_typ, inserate_daten und assets setzen. Beispiel:
[{
"external_id": "xxxxxxxx"
"inserate_typ": "stellen-angebot",
"inserate_daten": {
"category": "9",
"title": "Testinserat",
"teaser": "Diese Wohnung bietet ein Vielerlei an Komfort, Exklusivit\u00e4t und Sicherheit.",
"description": "F\u00fcr Sicherheit sorgen die Zug\u00e4nglichkeit der Wohnung \u00fcber einen gut erreichbaren Aufzug, der barrierefreie Zugang ...",
"link": "https://www.example.net",
"zip": "8304",
"city": "Wallisellen",
"canton": "ZH",
"type": "Dauerstelle",
"quota": "80",
"begin": "12",
"visible": "false"
},
"assets" : {
"kopfbild": "https://www.example.net/kopfbild.jpg",
"galerie-0": "https://www.example.net/bild-1.jpg",
"galerie-1": "https://www.example.net/bild-1.jpg",
// usw...
},
"hidden": 0
},
{ ... },
{ ... },
]Felddefinitionen
Beschreibung Feld "external_id"
Hierüber wird das Inserat identifiziert und die Schnittstelle erkennt hierüber, ob das Inserat noch nicht auf der Plattform und somit neu ist, oder ein bestehendes Inserat auf der Plattform geändert werden soll.
Beschreibung Feld "inserate_typ"
Hierüber geben Sie an, um was für eine Art Inserat es sich handelt. Je nach Inserate-Typ stehen dann andere Felder unter "inserate_daten" zur Verfügung, und das Inserat wird dann unter der korrekten Rubrik veröffentlicht. Beachten Sie auch, dass je nach Inserate-Typ, unterschiedliche Kosten pro Inserat anfallen (siehe Preise).
Zur Verfügung stehen folgende Werte: stellen-angebot, stellen-gesuch, marktplatz-angebot, immobilien-angebot, immobilien-gesuch.
Beschreibung Feld "assets"
Hierüber steuern Sie die einzubindenden Bilder für das Inserat. Geben Sie pro Bild eine öffentliche URL an - die Schnittstelle ruft diese dann ab und speichert sie lokal ab (es findet kein Hotlinking statt).
Zur Verfügung stehen folgende Werte:
- kopfbild: wird als erstes beim Inserat oben angezeigt und ist gleichzeitig auch das erste Bild der Galerie
- logo: wird bei gewissen Inserate-Typen (z.B. Stellenanzeige) zusätzlich angezeigt
- galerie-0: weiteres Bild für die Galerie
- galerie-1: weiteres Bild für die Galerie
- galerie-2: weiteres Bild für die Galerie
- usw.
Beschreibung Feld "hidden"
Wenn dies auf 1 gesetzt wird, dann wird das Inserat nicht geschaltet, steht aber im Login-Bereich als "Entwurf" zur Verfügung. Dies ist praktisch, wenn man die Schnittstelle testen möchte, ohne dass Kosten für die Aufschaltung anfallen. Auch kann man das Feld verwenden um Vorerfassungen via Schnittstelle zu machen, welche man im Login-Bereich dann (manuell) aufschalten kann.
Beschreibung Feld "inserate_daten"
Je nach eingestelltem Inserate-Typ, stehen hier unterschiedliche Felder zur Verfügung:
Allgemeine Felder für alle Inserate-Typen:
- category: Unter-Kategorie des Inserates (siehe weiter unten für eine Liste)
- title: Titel des Inserats
- teaser: Vorschautext, wird in der Übersicht angezeigt
- description: Lang-Beschrieb
- visible: 1 = Kontaktinformationen anzeigen, 0 = verbergen (Chiffre-Inserate)
- gender: Geschlecht (Herr, Frau)
- firstname: Vorname (Freitext)
- lastname: Nachname (Freitext)
- address: Adresse (Freitext)
- tel: Telefonnummer (Telefonnummer)
- email: E-Mail (E-Mail)
Stellen-Angebot:
- link: Web-Link zum Inserat
- zip: Arbeitsort Postleitzahl
- city: Arbeitsort Ort
- canton: Arbeitsort Kanton (zweistellig, z.B. 'ZH')
- type: Art der Anstellung (Freitext)
- quota: Anstellungspensum (Freitext)
- begin: Anstellungsbeginn (Freitext)
Stellen-Gesuch:
- zip: Arbeitsort Postleitzahl
- city: Arbeitsort Ort
- canton: Arbeitsort Kanton (zweistellig, z.B. 'ZH')
- type: Art der Anstellung (Freitext)
- quota: Anstellungspensum (Freitext)
- begin: Anstellungsbeginn (Freitext)
Marktplatz-Angebot:
- link: Web-Link zum Inserat
- price: Preis des Angebotes (Freitext)
- zip: Arbeitsort Postleitzahl
- city: Arbeitsort Ort
- canton: Arbeitsort Kanton (zweistellig, z.B. 'ZH')
Immobilien-Angebot:
- link: Web-Link zum Inserat
- zip: Arbeitsort Postleitzahl
- city: Arbeitsort Ort
- canton: Arbeitsort Kanton (zweistellig, z.B. 'ZH')
- transfer: Datum der möglichen Übernahme (Freitext)
- size: Grösse der Immobilie (Freitext)
- price: Preis der Immobilie (Freitext)
Immobilien-Gesuch:
- link: Web-Link zum Inserat
- zip: Arbeitsort Postleitzahl
- city: Arbeitsort Ort
- canton: Arbeitsort Kanton (zweistellig, z.B. 'ZH')
- transfer: Datum der möglichen Übernahme (Freitext)
- size: Grösse der Immobilie (Freitext)
- price: Preis der Immobilie (Freitext)
Verwendbare Inserate-Kategorien
Jedes Inserat muss genau einer Kategorie zugeordnet sein, unter welcher das Inserat dann auf der Plattform erscheint (Beispiel Stelleinserate -> Fachkräfte -> Gourmetküche). Es stehen die folgenden Kategorie-Schlüssel zur Verfügung:
