Zoddak
Connect Zoddak to search Spanish new-build developments, with prices, units, photos and build stage, beside your own listings.
Zoddak lists new-build and off-plan developments in Spain. Connecting your agency's Zoddak account puts those developments in Fondaro's search, with price ranges, available units, photos and build stage, so you can show them to buyers and add them to brochures. Fondaro reads Zoddak live with your agency's own token.
Set it up
- In your Zoddak portal, add Fondaro's server address (shown on the setup page in Fondaro) so Zoddak accepts requests on your behalf, and copy your API token.
- In Fondaro, an admin opens Settings › Integrations › Zoddak and pastes the token. By API, an admin session can save it with
PUT /integrations/credentials/zoddak/api_token:
POST /integrations/credentials/zoddak/test checks it again and DELETE /integrations/credentials/zoddak/api_token disconnects.
Search developments
Use the zoddak source of Property sources with an API key that has sources:read. It filters by location (zone, province, town or place), property type, price, bedrooms, bathrooms and build stage. A location is optional.
The stage values come from GET /property-sources/zoddak/options/stage, and a development with its units from GET /property-sources/zoddak/detail/:id.
Check the connection
GET /zoddak/status
Signed-in session. Whether the saved token passed its latest live check, cached for 6 hours after a pass and 5 minutes after a failure.
connection.status is connected, attention (saved but failing; reason and message say why) or disconnected.
Dashboard routes
The dashboard and older app versions use these session-only routes. They answer in their own shapes and return Deprecation: true with a Link header naming the replacement.
| Method and path | Purpose | Replacement |
|---|---|---|
POST /zoddak/search | Developments (page, limit up to 20, propertyTypeEnums, towns, places, provinces, zones, stages, minPrice, maxPrice, minBeds, maxBeds, minBaths, maxBaths, sort price_asc or price_desc) | POST /property-sources/zoddak/search |
GET /zoddak/detail/:reference | One development with its units | GET /property-sources/zoddak/detail/:id |
GET /zoddak/locations | Zones, provinces, towns and places (?query=) | GET /property-sources/zoddak/locations |
GET /zoddak/stages | Build stages with labels in 11 languages | GET /property-sources/zoddak/options/stage |
Bedroom and bathroom filters apply to a development's smallest unit.
Errors
| Status | When |
|---|---|
400 | Zoddak is not connected, or a field is invalid |
403 | Saving the token without being an admin |
404 | No development with that reference |