Sign up to our newsletter

Sign up to our newsletter

Acceptable Use Policy

Best Practices for XML Based Feeds V1.2

Introduction

Target Audience

This document is intended for third party web developers/application developers, seeking to use the XML based integration services hosted on the website dezrez.com

Overview

The purpose of the document is to outline best practices when obtaining data from dezrez web services, and to inform third parties about the automated blacklisting system that we have in place.

Dezrez web services information

For detailed information about the web services that dezrez offer for third party integrators, please see the documentation hosted here

Acceptable User Policy guidelines

Background

When an XML feed is set up for a third party (you), an API Key is issued to you and you are authorised to obtain XML information for all available property details for the subscribing estate agent(s). This key is used to manage your access to our XML services.

Request filtering

Dezrez is a multi-tenanted online service, and we aim to keep availability levels as high as possible. There may be some situations in which particular heavy access patterns cause response times to increase. In order to keep the system at top performance, and fully available, we need to police the way in which third parties access data. This means applying a fair policy on acceptable use, so that one party doesn’t cause problems for other parties. In order to do this, requests to the dezrez web services are subject to an automated request filtering system.

Technical implementation

An automated system programmatically identifies if a third party (Identified by its API key or IP address) is monopolising system resources, and corrects this by “throttling” the requests.
Request throttling is implemented by the server, and uses RFC 6585 and RFC 2616 compliant HTTP status codes to inform client applications that they are the subject of rate limiting. As a result, you must confirm that any request you make to our web services has a response code of 200 (OK) before you treat it as valid data.

So what do I need to make sure I do?

– Make sure there is a 100ms delay between any data requests, including media.
– Wait for a HTTP 200 response before making your next request.
– Check the updated date/time on each property before requesting the property full details.

FAQs

Do I need to pause between requests?

We recommend so, yes. Leave an appropriate amount of “stand-off” time between batches of requests. We recommend introducing a 100ms delay between individual requests. Repeated back-to-back requests (“Hammering”) is very likely to trigger to automated filter.

What happens if I am “throttled”?

When the automated system detects an excessive amount of requests that fall foul of these guidelines, it may introduce one of the following sanctions:

  • Time delay in response

    • This delay may increase if behaviour continues

  • Temporary suspension

    • Requests will return HTTP status code 429 (Too Many Requests), and a plain text message explaining what has happened

  • Permanent suspension

    • Requests will return HTTP status code 403 (Forbidden), and a web form that explains what has happened and why. This form can be submitted to appeal the suspension.

Do i need to store the update date my side?

Yes – This will allow you to determine if the information you hold is out of date when comparing the updated date we provide in the search results.

How can I appeal against a blacklisting decision?

If the automated system has blacklisted your API key or your IP address, when you make a request to our web services, a web form is shown – fill this form in and submit it in order to appeal the blacklisting. Alternatively, you may contact us via email – portals@dezrez.com

Questions? Call us

Call the data feed team

0845 465 2222 Opt 3

Email

Email one of the team today

Email data feeds

Email

Need web support? Email one of the team

Email Web

Our experience working with Dezrez has been seamless. We’ve a large number of Dezrez agents listing with us and to date, exactly zero have had any problems. The key reason for this is that their software is rock solid dependable. Their support and advice team has a terrific reputation and agents seem very pleased with the whole package offered - they deliver results

Rhys Davies – Propertini

Find out how Rezi can make your business succeed

We've been around for a while and it's been noticed. About us.

National Business Awards
Deloitte fast 50