Website advertising - introduction

This category aims to support website developers, providing websites for real estate agents, in the use of the RealEquity REST API.

Topics in this category only handles issues of a general nature and will never be customer specific.

Introduction and support

Introduction

Developer Forum contains - primarily in the “General API” category and under top menu item Docs - information aimed at people working with website development and operation.

Support

If you have any questions regarding integrationen with RealEquity, or you encounter technical issues, or are struggling with data interpretation, you should create 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 returns 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 purposes we’ve created examples of how you can compose graphQL requests that returns, case list, case presentation 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 the 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 fx. ordering of salesvaluation, wish details for house searches or open house signup.

The supported requests -and how to use then - are described in this topic Working with requests under “Generel API” → “Requests”

Visit- and downloadstatistics

The agents business application on the RealEquity platform offers Visit- and downloadstatistics on the individual case.

The underlying data for these statistics must be provided by er data, der leveres af 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 Forums frontpage opens a liste of documents, ranking the most recently ones first..

Case Types, Estate Types and their taxonomies

The contents of the document Case Types, Estate Types and their taxonomies is essential to be able to identify the type and charactaristics 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’ts sold?

Case states

The document Stateflows, states and endresults on cases provides you with an overview of the states than can apply to a sales og 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..