Offene API v1

Entwickeln Sie mit ElefyMove

Verbinden Sie Ihre Plattform mit ElefyMove: Inserate veröffentlichen, Verfügbarkeiten in Echtzeit synchronisieren und dasselbe Datum nie wieder doppelt buchen.

Anmelden / API-Schlüssel erhalten API-Referenz ansehen

Was die API kann

Eine einzige Integrationsschnittstelle für Inserate, Verfügbarkeit und Echtzeit-Synchronisation.

Listings-API

Übertragen Sie mehrsprachige Immobilieninserate an ElefyMove. Inhalte können in jeder Teilmenge unserer 9 unterstützten Sprachen eingereicht werden; jedes Inserat wird vor der Veröffentlichung geprüft.

Verfügbarkeits-Synchronisation

Der Master-Kalender von ElefyMove ist die einzige verbindliche Datenquelle für alles Buchbare auf der Plattform. Jeder Zeitraum trägt einen Status — verfügbar, temporär reserviert, gebucht oder gesperrt —, und Pufferzeiten für die Reinigung werden zentral durchgesetzt, sodass keine Doppelbuchung über verschiedene Kanäle hinweg entstehen kann.

Temporäre Reservierungen

Legen Sie eine kurzfristige Reservierung von bis zu 10 Minuten an, während der Gast den Bezahlvorgang auf Ihrer Seite abschließt. Konflikte werden nach dem Prinzip „wer zuerst kommt, mahlt zuerst“ gelöst; die unterlegene Anfrage erhält eine maschinenlesbare 409-Antwort.

Webhooks

Abonnieren Sie mit HMAC-SHA256 signierte Ereignisse — Inserat-Freigaben, Verfügbarkeitsänderungen, den Lebenszyklus von Reservierungen und Buchungsstatus — nahezu in Echtzeit. Die Payloads enthalten ausschließlich Daten und Referenzen, niemals personenbezogene Gästedaten.

iCal-Synchronisation

Jedes Inserat exportiert einen signierten iCal-Feed, und ElefyMove kann umgekehrt auch Ihren eigenen Feed abrufen — externe Sperrungen bleiben so auf beiden Seiten konsistent, ganz ohne zusätzlichen Integrationscode.

Was Partner dürfen — und was nicht

Regel null: Jede Operation ist auf Ihre eigenen Daten beschränkt. Es gibt keinen partnerübergreifenden Zugriff, in keine Richtung.

Sie dürfen

Ihre eigenen Immobilieninserate erstellen, aktualisieren und deaktivieren, in jeder unserer 9 Sprachen
Ihre eigenen Inserate und deren Moderationsstatus einsehen
Die Verfügbarkeit Ihrer eigenen Inserate abrufen und externe Kanalsperren mit einer Referenz eintragen
Temporäre Reservierungen anlegen und wieder freigeben, bis zu 10 Minuten, während Ihres Checkouts
Webhooks registrieren und signierte Ereignisse empfangen — nur Datum und Referenz
Inseratskalender (iCal) exportieren und Ihre eigenen iCal-Feeds registrieren
Die öffentliche Standort-Hierarchie abrufen

Sie dürfen nicht

Zahlungen, Rückerstattungen oder Kautionen über diese API bewegen
ElefyMove-Buchungen oder -Verträge erstellen — eine externe Buchung wird nur als Kalendersperre erfasst
Personenbezogene Daten von Gästen oder Mietern senden oder empfangen
Auf Inserate, Reservierungen, Sperren oder Konfigurationen anderer Partner zugreifen oder diese ändern
ElefyMove-Nutzer kontaktieren, anschreiben oder umwerben
Inserate einsehen oder erneut veröffentlichen, die Ihnen nicht gehören
Ratenlimits überschreiten, Schlüssel weitergeben oder die Kontoerstellung automatisieren

Vollständige API-Nutzungsbedingungen lesen

Zugang erhalten

Erstellen Sie ein Entwicklerkonto, bestätigen Sie Ihre E-Mail-Adresse und stellen Sie Ihre eigenen API-Schlüssel direkt im Dashboard aus. Für die Veröffentlichung echter Inserate muss das ElefyMove-Team Ihren Schlüssel zusätzlich mit einem verifizierten Vermieterkonto verknüpfen.

API-Schlüssel erstellen

Mit der Kontoerstellung stimmen Sie den API-Nutzungsbedingungen zu.

Verfügbare Berechtigungen (Scopes)

listings:readlistings:writeavailability:readavailability:writeholds:writewebhooks:manage

Standard-Ratenlimit: 120 Anfragen pro Minute je Schlüssel.

Schnellstart

Jede Anfrage wird über einen X-Api-Key-Header mit Ihrem ausgestellten Schlüssel authentifiziert.

Verfügbarkeit eines Inserats abfragen

curl "https://elefymove.com/api/public/v1/listings/{listingId}/availability?from=2026-09-01&to=2026-09-30" \
  -H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx"

# Response — 200 OK
[
  { "from": "2026-09-01", "to": "2026-09-14", "state": "AVAILABLE" },
  { "from": "2026-09-15", "to": "2026-09-20", "state": "BLOCKED", "source": "partner-site", "externalRef": "HMXYZ123" },
  { "from": "2026-09-21", "to": "2026-09-30", "state": "AVAILABLE" }
]

Eine temporäre Reservierung anlegen

curl -X POST "https://elefymove.com/api/public/v1/listings/{listingId}/holds" \
  -H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-09-15", "to": "2026-09-20", "ttlSeconds": 300}'

# Response — 201 Created
{ "holdId": "hld_9f3a2c1b", "expiresAt": "2026-08-13T10:15:00Z" }

Die unterlegene Anfrage erhält eine maschinenlesbare 409-Antwort

# Same request, the dates were just taken by another channel
# Response — 409 Conflict
{
  "code": "SLOT_TAKEN",
  "conflictingState": "HELD",
  "wonBy": "external"
}

OpenAPI / Swagger

Vollständige API-Referenz

Alle Request- und Response-Schemas, Fehlerformate und Beispiele stehen in der interaktiven OpenAPI-Referenz — jeden Endpunkt live mit dem eigenen Key ausprobieren.

API-Dokumentation öffnen Zur vollständigen Dokumentation

Alle Endpunkte auf einen Blick

Die vollständige Open API v1. Jede Anfrage trägt Ihren Key im Header X-Api-Key, und jede Route greift ausschließlich auf Ihre eigenen Daten zu.

Basis-URL https://elefymove.com

Inserate

Methode	Endpunkt	Scope	Funktion
POST	`/api/public/v1/listings`	`listings:write`	Ein neues Inserat zur Prüfung einreichen — mit Inhalten in beliebigen der 9 unterstützten Sprachen.
GET	`/api/public/v1/listings`	`listings:read`	Alle Inserate dieses Keys mit ihrem aktuellen Prüfstatus auflisten.
GET	`/api/public/v1/listings/{externalId}`	`listings:read`	Ein eigenes Inserat über die von Ihnen vergebene externe ID abrufen.
PATCH	`/api/public/v1/listings/{externalId}`	`listings:write`	Ein eigenes Inserat aktualisieren; ausgelassene Felder bleiben unverändert.
DELETE	`/api/public/v1/listings/{externalId}`	`listings:write`	Ein eigenes Inserat offline nehmen.

Verfügbarkeit und Sperren

Methode	Endpunkt	Scope	Funktion
GET	`/api/public/v1/listings/{id}/availability`	`availability:read`	Den zusammengeführten Kalender eines Inserats für einen Zeitraum abrufen — frei, reserviert, gebucht oder gesperrt.
POST	`/api/public/v1/listings/{id}/blocks`	`availability:write`	Eine Sperre aus einem externen Kanal anlegen oder aktualisieren, identifiziert über Ihre eigene Referenz.
DELETE	`/api/public/v1/listings/{id}/blocks/{externalRef}`	`availability:write`	Eine zuvor geschriebene Sperre aus einem externen Kanal entfernen.

Temporäre Reservierungen

Methode	Endpunkt	Scope	Funktion
POST	`/api/public/v1/listings/{id}/holds`	`holds:write`	Einen Zeitraum reservieren, während der Gast bei Ihnen bezahlt. Die unterlegene Anfrage erhält einen 409 mit SLOT_TAKEN.
DELETE	`/api/public/v1/holds/{id}`	`holds:write`	Eine eigene Reservierung vor Ablauf freigeben.

Kalendersynchronisierung (iCal)

Methode	Endpunkt	Scope	Funktion
GET	`/api/public/v1/listings/{id}/calendar.ics`	Signierte URL, kein Key	Den Kalender eines Inserats als iCal-Feed abrufen. Das signierte Token in der URL ist die Authentifizierung, sodass Kalender-Apps direkt abonnieren können.
PUT	`/api/public/v1/listings/{id}/ical-sources`	`availability:write`	Den eingehenden iCal-Feed registrieren oder ersetzen, den ElefyMove für eines Ihrer Inserate abruft.
GET	`/api/public/v1/listings/{id}/ical-sources`	`availability:read`	Den registrierten Feed eines Inserats samt Abrufstatus und letztem Fehler abrufen.
DELETE	`/api/public/v1/listings/{id}/ical-sources`	`availability:write`	Den Abruf beenden und den registrierten Feed eines Inserats löschen.

Webhooks

Webhooks haben in v1 keinen Endpunkt, den Partner selbst aufrufen. Senden Sie uns mit der Key-Anfrage Ihre Ziel-URL, dann registriert das ElefyMove-Team sie zusammen mit dem HMAC-SHA256-Secret, mit dem jede Zustellung signiert wird. Fehlgeschlagene Zustellungen werden mit wachsendem Abstand wiederholt, und die Payloads enthalten nur Daten und Referenzen.

Empfangbare Events

listing.approvedlisting.rejectedavailability.changedhold.createdhold.releasedhold.expiredbooking.createdbooking.cancelledping

Allgemein

Methode	Endpunkt	Scope	Funktion
GET	`/api/public/v1/ping`	Jeder gültige Key	Prüfen, ob der Key funktioniert, und Clientname sowie zugeordnete Scopes auslesen.

Daten und faire Nutzung

Über die API werden niemals personenbezogene Gästedaten übertragen — externe Sperrungen enthalten ausschließlich Datum und Referenz, im Einklang mit dem thailändischen Datenschutzgesetz PDPA.
Über die API eingebrachte Inserate verlinken stets zurück auf ihre kanonische Seite auf elefymove.com.
Schlüssel sind mit klar definiertem Umfang versehen und können vom ElefyMove-Team jederzeit widerrufen werden.

Offene API v1 — derzeit läuft die Aufnahme von Integrationspartnern.