Zwei POST-Endpunkte zum Starten und Überwachen von Importen. Ein API-Schlüssel ist erforderlich. Importe laufen asynchron — nach /start den Status mit /latest-log abfragen.
POST /rest-api/import/start → import-in-queue.POST /rest-api/import/latest-log pollen, bis completed.curl -X POST 'https://realistimo.com/rest-api/import/start' \
-H 'Accept: application/json' \
-H 'API-KEY: YourApiKeyHere'
curl -X POST 'https://realistimo.com/rest-api/import/latest-log' \
-H 'Accept: application/json' \
-H 'API-KEY: YourApiKeyHere'
How-to
<updated> (unveränderter Wert überspringt den Feed).<last_update> bei geänderten Angeboten.POST /start. Bei Cooldown oder laufendem Import warten und erneut versuchen./latest-log pollen und Angebote mit errors korrigieren.API-KEY (empfohlen)apikey| Antwort | Wann |
|---|---|
| HTTP 401 | Fehlender oder leerer API-Schlüssel |
{"status":"error","message":"API key could not be found"} | Unbekannter Schlüssel |
{"status":"error","message":"API key is inactive"} | Deaktivierter Schlüssel |
{"status":"error","message":"API key is expired"} | Abgelaufener Schlüssel |
{"status":"error","message":"User is inactive"} / User account is expired | Problem mit dem Benutzerkonto |
POST /rest-api/import/start| message | Bedeutung |
|---|---|
import-in-queue | Akzeptiert; Import ist in der Warteschlange oder wartet bereits |
import-is-allowed-between-the-time | Außerhalb des Fensters 08:00–20:59 (Serverzeit) |
import-in-progress | Ein Import läuft bereits |
import-request-cooldown-is-time-given | 30 Minuten zwischen Anfragen warten (Production) |
error-while-importing | Kein Feed für die Agentur konfiguriert |
error: Agency not found | Schlüssel ist keiner Agentur zugeordnet |
POST /rest-api/import/latest-logmessage ist der Importstatus: pending | in_progress | completed (oder null, falls noch keiner). Bei vorhandenem Log: logDate, logResult, logOffers (uuid, createdAt, errors, offerSourceData).
{
"message": "completed",
"logDate": "2024-09-18T01:51:14+03:00",
"logResult": { "found_offers": 228, "updated_offers": 228, "not_published": 10 },
"logOffers": [{ "uuid": "…", "errors": [], "offerSourceData": { "offer_uid": "2080525" } }]
}
Reference
<updated>): XML-Spezifikationresult_url)Nach dem Import sendet Realistimo JSON im latest-log-Format per POST an die XML-result_url. Fehlgeschlagene Callbacks werden nicht automatisch wiederholt.
Lass Realistimo für dich mitverfolgen
😃 Installieren Sie die App und wir benachrichtigen Sie zuerst, wenn ein passendes Angebot erscheint.
Mit dem Handy scannen, um die App herunterzuladen:
So bleiben Sie auf dem Laufenden über Neuigkeiten, Statistiken und Nachrichten von Realistimo, ohne Spam: