Skip to content

Send requests with Postman

We provide a collection of requests that are executed with our APIs. These collections are collections that can be created and executed with Postman.

Postman is one of the most popular tools for testing APIs. In Postman, all aspects of a request can be displayed and changed, including the request type and authentication. This is helpful when developing and using existing APIs, as it is easy to see which parameters are passed and what the return value looks like. Postman is available in different versions, ranging from simple free licenses for individual users to large enterprise versions.

Postman is available on all common operating systems such as Windows, MacOS and Linux.

You can visit Postman by following the link https://postman.com

Here we discrib how you do the oAuth Flow using Postman and our Postman oAuth1flow Collection.

That is import to use all our other Postman Collections.

First import the "OAuth1flow" collection into your Postman application.

In "Postman Collections" click on the Button "Run in Postman".

You can "Fork Collection" or you can open a copy of that collection.

run_in_postman

The Collection will open in your workspace within Postman.

View Documentation

We have added instructions to help you with the authentication process. You can find this by opening the folder (click on the arrow next to the folder). Then click on the three dots next to “Before you start !! Initiate OAuth1” and select “View Documentation”.

OAuth1 flow

Select Environment

Before you start with the individual steps, click on the arrow at the top right next to the “eye” and select “IS24 Sandbox”.

Environmental

Then click on the “eye” and fill in the fields “oauth1.Key” (API key) and “oauth1.secret” (API password). To do this, enter the values in the slot “CURRENT VALUE”.

If you haven't created a consumer key and secret yet, visit our Get Your Client Credentials section to create them.

Sandbox-Variables

Now follow the documentation.

Initiate OAuth1 flow

Step 1: GET Request Token

https://rest.sandbox-immobilienscout24.de/restapi/security/oauth/request_token

With this call we receive an intermediate token. We use this token to confirm access and to request an access token in step 3.

Execute the request and then perform the following steps:

  1. Store oauth_token from response in the variable oauth1.token
  2. URL decode the response value oauth_token_secret and store it in the oauth1.token.secret variable in the "IS24-Sandbox" environment. You are ready to proceed to step 2.

Step 2: GET Perform in browser! - Confirm access

https://rest.sandbox-immobilienscout24.de/restapi/security/oauth/confirm_access?oauth_token=

Use this call to confirm the personalized token.

  1. Go to the browser
  2. Login to Sandbox with the sandbox username and password.
  3. Execute the request by replacing the parameter value of oauth_token with oauth1.token sandbox environment variable value. Replacing oauth-token within the URL
  4. When the access has been confirmed, copy oauth_verifier and put it into the oauth1.verifier variable on the "IS24-Sandbox" environment. Replacing oauth-token within the URL

Step 3: GET Retrieve (long term) access token

https://rest.sandbox-immobilienscout24.de/restapi/security/oauth/access_token

This call uses the intermediate request token to receive a long term access token.

Now replace the variables oauth1.token and oauth1.token.secret (URL decode the secret) with the returned values in the "IS24-Sandbox" environment and continue!

Video "How to do the OAuth Flow"

We have summarized all the steps within a video to show how to do it.