POSTbyList RealEstateProjectEntry

This method adds a real estate to a project. You can add a list of realestates.

https://rest.immobilienscout24.de/restapi/api/offer/v1.0/user/username/realestateproject/{realEstateProjectId}/realestateprojectentry

  • You can use your own object ID (externalId) by POSTing a real estate object to a project
  • Use <realEstateExternalId> instead of <realEstateId> in your body, so you don't need the prefix "ext-"
  • ATTENTION: At the moment it's necessary to publish the realEstate before you adding it to the realEstateProject because it's impossible to publish unpublished realEstates in the realEstateProject. If you deaktivate a realEstates in the realEstateProject and publish it again some time late you must delete that object from that project, publish it via vario contingent and added than again to that realEstateProject.

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

A System Key and an authenticated user are required for this operation:

Please use a secure connection (https) for this operation.

Request

Path Parameters

  • Username: the username which the user uses for logging in to www.immobilienscout24.

  • Username: "me" can be used instead of the username, when the user is logged in by 3-legged oauth.
  • realestateprojectid: the unique project ID, generated by IS24 when posting a real estate project

Query Parameters

  • none

Body

XML

<realestateproject:realEstateProjectEntries xmlns:realestateproject="http://rest.immobilienscout24.de/schema/offer/realestateproject/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns4="http://rest.immobilienscout24.de/schema/platform/gis/1.0">
   <realEstateProjectEntry>
      <realEstateId>123456</realEstateId>
   </realEstateProjectEntry>
   <realEstateProjectEntry>
      <realEstateExtneralId>myRealEstate</realEstateExternalId>
   </realEstateProjectEntry>
</realestateproject:realEstateProjectEntries>

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.

  • Status 201 Created
  • This status code is returned after a new entity of a resource was successfully created.

Header

No special headers.

Body

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<realestateproject:realEstateProjectEntries xmlns:realestateproject="http://rest.immobilienscout24.de/schema/offer/realestateproject/1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns4="http://rest.immobilienscout24.de/schema/platform/gis/1.0">
    <realEstateProjectEntry>
        <messageCode>MESSAGE_RESOURCE_CREATED</messageCode>
        <message>real estate with id 123456 was added to project 987</message>
        <realEstateId>62455263</realEstateId>
    </realEstateProjectEntry>
    <realEstateProjectEntry>
        <messageCode>MESSAGE_RESOURCE_CREATED</messageCode>
        <message>real estate with external id myRealEstate was added to project 987</message>
        <realEstateExternalId>myRealEstate</realEstateExternalId>
    </realEstateProjectEntry>
</realestateproject:realEstateProjectEntries>