Delete an OnTop placement
This method provides a way to delete a single OnTop Placement. This means, that the connection of a certain real estate to the OnTop Placement is being deleted, not the OnTop Placement booking. This method can only be used every 24 hours.
DELETE /offer/v1.0/user/{username or me}/realestate/{id or externalid}/{ontop placement}
Supported media types:
Possible OnTop Placements:
- showcaseplacement ("Schaufenster-Platzierung")
- premiumplacement ("Premium-Platzierung")
- topplacement ("Top-Platzierung")
Request
Path Parameters
| PARAMETER | DESCRIPTION |
|---|---|
| Username | the username which the user uses for logging in to www.immobilienscout24 |
| me | "me" can be used instead of the username, when the user is logged in by 3-legged oauth |
| id | the unique scout object ID, which is being created by POST REALESTATE automatically |
| external-id | can be used instead of the scout object ID. it is the customer-defined ID of the real estate, must be unique per user |
| ontop placement | the type of the OnTop placement (showcaseplacement, premiumplacement or topplacement) |
Response
XML:
1 2 3 4 5 6 | |
or 412 (if you try to delete the connection between real estate and premium placement within 24h)
1 2 3 4 5 6 | |