Craftplaces API - Alle Fragen und Antworten

Die Craftplaces API liefert dir die Termine von Unternehmen mit wechselnden Standorten wie Foodtrucks, Street Food oder detaillierte Informationen über regionale Märkte.

Bereit für Street Food? Melde dich jetzt kostenlos an!

Fragen und Antworten

Du hast bestimmt noch weitere Fragen. Hier findest du alle Antworten zu den am häufigsten gestellten Fragen zum Thema Vorteile

Kann ich die aktuellen Termine von bestimmten Foodtrucks auf meiner Webseite einbinden?

Ja, du kannst über den Endpunkt Typ “Anbieter” deinen gewünschten Foodtruck auswählen und dann entscheiden, für welchen Zeitraum du die Termine anzeigen lassen möchtest.

Für welchen Zeitraum kann ich die Termine anzeigen lassen?

Es stehen dir die Zeiträume: Heute, morgen, heute und morgen, die nächsten 7 Tagen und die nächsten 14 Tage zur Verfügung.

Kann ich die Termine auf einem Monitor im Eingangsbereich anzeigen?

Ja, die Craftplaces API liefert dir alle Termine für einen oder mehrere Standorte. Diese kannst du dann minutenaktuell anziegen und so Besucher oder Mitarbeiter informieren.

Sehe ich auch, was an diesen Termine angeboten wird?

Ja, du bekommst neben den Öffnungszeiten und dem genauen Standort auch die Information darüber, mit welchem Angebot beispielsweise der Foodtruck unterwegs ist.

Ich bin selber Foodtruck und möchte meine Termine auf meiner Homepage.

Nichts leichter als das. Du kannst die Craftplaces API nutzen, um deine Termine immer aktuell auf deiner Homepage zu veröffentlichen. Es ist auch möglich, auf der Startseite z.B. die Termine heute und morgen und dann auf der Unterseite Termine alle deine Termine für die nächsten 14 Tage anzuzeigen.

Ich plane eine neue App und da würden die Street Food Termine sehr gut passen.

Das klingt doch super, wir freuen uns auf jede neue Lösung, die in Zusammenhang mit der Craftpalces API entsteht. Melde dich bei uns: api@craftplaces.com und wir finden eine Lösung.

Wie kann die Craftplaces API Kantinen unterstützen?

Für Kantinen bedeutet es immer einen zusätzlichen Organisationsaufwand, auch die Termine der Foodtrucks zu kommunizieren. Die Craftplaces API liefert dir alle Termine automatisch und so kannst du die Mitarbieter mit Monitoren oder im Intranet immer aktuell informieren.

Ich möchte alle Street Food Termine für eine Stadt haben - geht das?

Ja, das geht. Die Craftplaces API liefert dir alle Termine von Unternehmen mit wechselnden Standorten wie Foodtrucks, Street Food oder regionale Märkte für von dir definierte Städte.

Bekomme ich alle Anbeiter für ein Event?

Ja, da ein Event immer an einem bestimmten Ort stattfindet, kannst du dir alle Anbieter für eben diesen Standort einfach ausgeben lassen.

Wie bekomme ich die Termine ins Firmen-Intranet?

Die Craftplaces API ist weltweit verfügbar und alle Daten liegen im JSON-Format vor. Daher können die Daten sehr leicht in gängige Softwarelösungen integriert werden.

Wie aktuell sind die Daten?

Die Daten über die Craftplaces API werden jede Minute aktualisiert, denn es kann immer etwas dazwischen kommen und nichts ist schlimmer, als hungrig an einem leeren Standort zu stehen.

Was benötige ich für die Craftplaces API?

Um die Craftplaces API zu nutzen benötigst du mindestens einen registrierten Zugang zur Free-Version. Die aktuelle Version der Craftplaces Rest API ist Version 1 (v1).

Was heiß, ich kann meine Endpunkte selber definieren?

Die Craftplaces API nutzt keine global definierten Endpunkte. Jeder Endpunkt erhält eine eindeutige ID und ist somit auf deinen genauen Bedarf zugeschnitten. Aus diesem Grund ist es auch nicht notwendig, separate API-Keys - wie beispielsweise bei der Google Maps API - zu nutzen.

Was passiert, wenn die API eine Fehler meldet?

Die Craftplaces API liefert grundsätzlich einen Status Code (responce code) von 200 zurück. Fehler werden mit den Werten “Code” und “messages” näher beschrieben. Am einfachsten erfolgt die Prüfung auf einen Fehler über den Wert “success”, der im Fehlerfall FALSE zurück gibt.

Welche Typen von Endpunkten gibt es?

Es stehen dir aktuell drei verschiedene Endpunkt-Typen zur Verfügung: Stadt, Anbieter und Standort. Zusätzlich kannst du noch den Zeitraum für den du die Termine haben möchtest über den Endpunkt steuern.

Wie schränke ich den Zugriff auf meine Endpunkte ein?

Um den Zugriff auf deine Endpunkte einzuschränken kannst du einen IP-Adressen filter einrichten, oder den Zugriff nur für bestimmte Domains freischalten.

Gibt es Demo Daten für die Entwicklung und zum Testen?

Ja, die gibt es. Die Demo Daten der Craftplaces API machen es sehr einfach, neue Lösungen zu entwickeln. Für jeden Endpunkt-Typ liegen eigene Demo Daten zur Verfügung und die Struktur der Daten entspricht exakt den Live Daten. Daher ist zum Livegang deiner Anwednung nur das Ändern des Endpunktes notwendig.

Sehe ich, wie häufig meine Endpunkte angerufen werden?

Du erhältst detaillierte Informationen, wie häufig auf deine Endpunkte zugegriffen wurde. Zusätzlich erhältst du auch die heutigen Zugriffe. Stichtag für die einzelnen Tage ist die Zeitzone “Europe/Berlin”.

Gibt es eine Begrenzung der Zugriffe pro Minute?

Um die Craftplaces API performant zu halten sind die Zugriffe auf 60 pro Minute und Besucher begrenzt. Diese Begrenzung der Zugriffe ist ausreichend für jedliche Anwendungsbeispiele, da der Zugriff nicht ausschließlich auf IP-Adressen basiert.

Was muss ich bei Aufruf meiner Endpunkte beachten?

Die Craftplaces API liefert grundsätzlich JSON Daten zurück. Alle Parameter, die mit POST, PUT und PATCH übermittelt werden können sowohl als JSON im Body sowie als form urlencoded übermittelt werden.

Benötige ich einen API Key für die Craftplaces API?

Die Craftplaces API hat keinen eigenen AP I Key. Alle Endpunkte werden von dir selbst über die App eingerichtet. Aus diesem Grund braucht es keine separaten Paramenter bei dem Aufruf der Endpoints.

Wie häufig kann ich meine Endpunkte kostenlos abrufen?

Die Anzahl der kostenlosen Zugriffe auf die Endpunkte ist auf 30.000 pro Monat beschränkt. Um deinen Service aber auch bei Überschreitung funktional zu halten, findet keine unmittelbare Begrenzung statt. Du wirst darüber informiert und erhältst die Möglichkeit dein Konto innerhalb von 48h aufzustocken. Erst wenn du innerhalb von 48h dein Konto nicht aufgestockt hast, werden keine Daten mehr geliefert und der Code “429” zurückgegeben.

Wie häufig werden die Termine aktualisiert?

Die Termine werden jede Minute aktualisiert, das bedeutet, dass sich ein Termine jederzeit ändern kann. Um deine Besucher und Nutzer immer aktuell zu halten ist es sinnvoll, die Daten häufiger abzurufen. Wenn du trotzdem die Termine zwischenspeichern möchtest, dann hat sich ein Caching von maximal 5 Minuten als sinnvoll herausgestellt.

Was mache ich, wenn ich eine eigene App entwickeln möchte?

Benötigst du für eine eigene App oder Portallösung Zugriff auf dynamische Standorte, Anbieter oder Städte, dann melde dich bei bei uns: api@craftplaces.com und wir finden eine passende Lösung.

Wir benötigen Unterstützung bei der Nutzung der API

Wenn du als Unternehmen oder Portalbetreiber mehr über die Craftplaces API erfahren möchtest, dann melde dich bei bei uns: api@craftplaces.com und wir finden eine passende Lösung.

Muss ich für jeden Zeitraum einen eigenen Endpunkt angeben?

Nein, das ist nicht notwendig. Du kannst bei jedem deiner Endpunkte den Zeitraum sleber festlegen. Somit kannst du einmal die Termine für heute und morgen und später mit dem gleichen Endpunkt die Termine für die nächsten 14 Tage abrufen.

Erhalte ich eine detailliere Aufschlüsselung der Zugriffe?

Ja, du kannst die eine detaillierte Aufstellung der Zugriffe herunterladen. Du erhältst eine exakte Aufschlüsselung, wann du welche Endpunkte aufgerufen hast. In der Rechnung werden deine Zugriffe gesammelt berechnet.

Wie bekomme ich die Rechnung?

Du erhältst jeden Monat bzw. je nach Kaufdatum die Rechnung per E-Mail zugesendet. Zusätzlich kannst du dir die Rechnung auch als PDF herunterladen.

Zahle ich für ein Kontingent an Abrufen?

Nein, wir berechnen dir jeden Zugriff einzeln. Wir denke, dass das ein faireres Preismodel für die Nutzung einer API ist.

Ab wann zahle ich für die Craftplaces API

Du erhältst jeden Monat 30.000 Zugriffe kostenlos. Ab dem 30.001ten Zugriff wird dir 0,0008€ berechnet.

© 2013 - 2021 Copyright Craftplaces GmbH - Alle Rechte vorbehalten