Platform

Η Casafari είναι η πλατφόρμα ευφυΐας δεδομένων ακινήτων για AI πράκτορες. Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων για οικιστικά και εμπορικά ακίνητα, προς πώληση και προς ενοικίαση, σε 16 χώρες.Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων.

Πώς δομείται ο γράφος

Claro AI · REST API

Set the webhook that receives your account's alerts

PUThttps://platform.casafari.com/v1/claro/alerts/webhook
API key1 παράμετρος

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform tokens; see platform sign-in and Claro AI. On the platform this is PUT https://platform.casafari.com/v1/claro/alerts/webhook; PUT /v1/alerts/webhook is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.

Over MCP: no tool does this. MCP and REST compared.

Description

Claro's email alerts (new matches, price cuts of 3% or more, saved premises that left the market or came back, and the area pulse) are also sent to your own systems or AI assistant: after each digest Claro POSTs its items for your account as one JSON body, {id, type: "claro.alerts", created_at, items}, the same items as GET /v1/alerts/feed. One webhook per account; PUT replaces it and returns a new signing secret, shown once. Each delivery carries Claro-Signature: t=<unix seconds>,v1=<hex>, the HMAC-SHA256 of <t>.<raw body> under your secret: recompute it, compare in constant time and refuse a t more than 5 minutes old. Answer with any 2xx within 8 seconds. Anything else is retried with back-off (after 1 min, 5 min, 30 min, 2 h and 12 h) and dropped after the sixth try; Claro-Delivery is the same on every retry, so deduplicate on it. The URL must be https on a public host name (no IP address, port or credentials).

Σώμα αιτήματος

Τύπος περιεχομένου application/json. Υποχρεωτικό. Τύπος: object.

urlstring (uri)απαιτείται
at most 300 characters

Παράδειγμα αιτήματος

Μόνο placeholders: αντικαταστήστε το token και τις τιμές με τα δικά σας.

curl
curl -X PUT "https://platform.casafari.com/v1/claro/alerts/webhook" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://hooks.example-customer.eu/claro"
}'

Αποκρίσεις

200 The webhook and its secret (shown once)

Χωρίς body.

Παράδειγμα από την περιγραφή του API
JSON
{
  "url": "https://hooks.example-customer.eu/claro",
  "secret": "whsec_Yq1x…"
}

400 Μη έγκυρο αίτημα

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

401 Κλειδί που λείπει ή δεν είναι έγκυρο

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

403 Χωρίς πρόσβαση

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

429 Υπέρβαση ορίου ρυθμού κλήσεων

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

Συμβουλή: προσθέστε .md σε οποιοδήποτε URL για να το διαβάσετε ως Markdown.