This category aims to support website developers who provide websites for real estate agents in the use of the RealEquity REST API.
Topics in this category only handle issues of a general nature and will never be customer specific.
Introduction and support
Introduction
The Developer Forum contains - primarily in the “General API” category and under the top menu item Docs - information aimed at people working with website development and operation.
Support
If you have any questions regarding integration with RealEquity, or you encounter technical issues, or are struggling with data interpretation, you should create a topic in the Partner Specific subcategory that has been designated to you.
Fetching data
graphQL
Access
Data is fetched from C&B by using graphQL requests which return a JSON formatted response.
Learn how to use graphQL at C&B in the topic Accessing graphQL at C&B Systemer which is located in the “General API” → “Website advertising” category.
The request POST URL is: https://graphql.prod.realequity.dk/graphql
Examples
For inspiration, we have created examples of how you can compose graphQL requests that return case lists, case presentations, and store information.
You’ll find the examples under the “General API” → “Website advertising” subcategory in the topic graphQL basic queries (examples)
Storing data
To be able to filter, order, and index data on your website, you need to store the data you fetch locally.
This will also make your website resilient to temporary interruptions in RealEquity in connection with updates or operational outages, should such occur.
Submitting data
Case update log
Let the user know when a case has been updated on the website by maintaining the destination log:
See how in this topic: Maintaining destination log
Request/Messages
RealEquity can receive a number of requests from our customers’ websites, like e.g. request for sales valuation, wish details for house searches, or open house signup.
The supported requests - and how to use them - are described in the topic Working with requests under “General API” → “Requests”
Visit and download statistics
The agents’ business application on the RealEquity platform offers visit and download statistics on the individual case.
The underlying data for these statistics must be provided by the agents’ own website. Under “General API” → “Case statistics” you’ll find the topic Reporting case statistics, which in short describes how visit and download information is submitted to RealEquity.
Other documentation
There are multiple approaches to documentation in Developer Forum.
The menu item Docs at the top of Developer Forum’s frontpage opens a list of documents, ranking the most recent ones first.
Case Types, Estate Types and their taxonomies
The contents of the document Case Types, Estate Types and their taxonomies are essential to be able to identify the type and characteristics of a case.
Is the case for sale or for rent? Is the property exempt from residency requirement (bopælspligt)? Is it a discretion case (skuffesag)? Is it allowed to advertise part of the information on the case even when it’s sold?
Case states
The document Stateflows, states and end results on cases provides you with an overview of the states that can apply to a sales or rental case.
It is crucial that you detect whether a case - according to its ‘stateNamespace’ at any given time - is actively for sale/rent or not.