Um Dir das Einbinden von Suchergebnissen unserer Seite zu erleichtern, haben wir eine API entwickelt.

API?!

API's sind Schnittstellen für Programmierer. Als nicht Eingeweihter ist der Inhalt dieser Seite wahrscheinlich eher irritierend und es ist vollkommen in Ordnung, wenn Du einfach wieder hier weg klickst.

Zugang

Um auf unsere API zugreifen zu können, brauchst Du einen API Token, schreib uns einfach an netzwerk@bessermitfahren.de.

Ausserdem gibt es auch noch eine Einschränkung, um für die Verwendung unserer API qualifiziert zu sein:

BesserMitfahren.de ist ein konsequent nicht-kommerzielles Portal. Wir verlangen keine Gebühren und schalten keine Anzeigen auf unseren Seiten.
Um unsere Ergebnisse im Rahmen deiner Seite anzeigen zu dürfen, darfst auch Du keine Gebühren verlangen und auch keine Werbeanzeigen schalten.

Auf diese Weise wollen wir sicherstellen, dass beim Thema Mitfahrgelegenheit der soziale Gedanke auch in Zukunft im Vordergrund steht.

Die Suchanfrage

wird an diese URL gesendet:

https://api.bessermitfahren.de/<TOKEN>?from=<Start>&to=<Ziel>&date=<Wann>

• from - Der Abfahrtsort. Das können Ortsname sein, aber es gehen auch Geokoordinaten (z.B. from=52.5072111,13.1449592 vs from=Berlin).
• to - Der Zielort. Auch hier, Ort, Stadt, Koordinaten...
• date - Wann soll gefahren werden. Es werden verschiedene Formatierungen verstanden und angewendet.

Die Antwort

ist ein JSON, welches alle zutreffenden Fahrten listet.

{
 "from": 0,
 "to": 1,
 "date": 1470348000,
 "places": ["Berlin", "Leipzig", "Leipzig ...", "... Berlin", "Leipzig-Halle Flughafen ..."],
 "resultset":
 {
  "1470348000":
  [
   [
    "https:\/\/www.bessermitfahren.de\/berlin\/leipzig\/mitfahrgelegenheit\/526721\/0\/1\/1470348000",
    ["10:00", 0, 0],
    ["11:59", 2],
    11,
    2,
    2,
    0
   ],
   [
    "https:\/\/www.bessermitfahren.de\/berlin\/leipzig\/mitfahrgelegenheit\/526772\/0\/1\/1470348000",
    ["17:00", 0, 0],
    ["19:04", 1],
    "10.00",
    3,
    3,
    2
   ]
  ]
 },
 "days": [1470348000]
}

In dieser Antwort sind nun mehrer Schlüssel enthalten:

Name	Typ	Beschreibung	Beispiel
from	Integer	Verweis auf einen Eintrag in places (siehe unten). Sollte der zur Suche übergebene Ort nicht erkannt worden sein, wird hier -1 stehen, und das gibt es natuerlich unter places nicht.	0
to	Integer	Verweis auf einen Eintrag in places (siehe unten). Sollte der zur Suche übergebene Ort nicht erkannt worden sein, wird hier -1 stehen, und das gibt es natuerlich unter places nicht.	1
date	unix timestamp	Das Datum nach dem gesucht wurde.	1470348000
places	Array	Eine Liste von Orten. Die oben verwendeten Zahlen für from und to verweisen auf Einträge dieser Liste. Ebenso auch die Ortsverweise in den gefundenen Fahrten (siehe unten). Mitunter werden hier auch Ortsnamen gelistet, denen "..." vor-, oder nachgestellt ist. Dann handelt es sich um einen Zwischenhalt auf der eigentlichen Fahrt. Zum Beispiel meint "Leipzig..." das diese Fahrt zwar wie gewünscht nach Leipzig führt, aber der Wagen hier nur hält und dann weiter zu seinem eigentlichen Ziel fährt.	["Berlin", "Leipzig", "Leipzig ...", "... Berlin", "Leipzig-Halle Flughafen ..."]
days	Array	Eine Liste der Tage (unix timestamps), zu denen Fahrten im resultset enthalten sind.	[1470348000,1470434400]
resultset	Object	Eine Liste von Tagen (unix timestamp) mit jeweils einem zugeordneten Array von Fahrten.	{ "1470348000": [ [ <Fahrt> ],[ <Fahrt> ], ... ], "1470434400": [ ... ] }

Die Fahrten sind hier nun noch einmal gesondert erläutert.

[
 "https:\/\/www.bessermitfahren.de\/berlin\/leipzig\/mitfahrgelegenheit\/526721\/0\/1\/1470348000", // Link zur Detailseite
 ["10:00", 0, 0], // [ Abfahrtszeit, Verweis auf places, ±Minuten Pünktlichkeit ]
 ["11:59", 2],    // [ Ankunftszeit, Verweis auf places ]
 11, // Preis in Euro
 2,  // Plätze noch frei
 2,  // Plätze Gesamt
 0   // Extras als Bitmaske
]

Diese Bitmaske kann folgende Werte enthalten:

• 1: Raucher
• 2: Hunde erlaubt
• 4: Zugmitfahrgelegenheit
• 8: Frauen für Frauen
• 16: Männer für Männer

Der Wert "3" würde dann also bedeuten, dass geraucht werden darf (1) + Hunde mitgenommen werden können (2) = 3.

Für die Verwendung dieser Schnittstelle bitten wir Dich auf die Menge der Requests zu achten, wenn möglich cache die Ergebnisse eine Weile.

Danke :)