# Bilder

## Bild hochladen

<mark style="color:green;">`POST`</mark> `https://api.propstack.de/v1/images`

Endpoint zum Hochladen eines Bildes. Ein Bild gehört immer entweder zu einem Projekt oder zu einem Objekt. Die Bilder-Parameter müssen um ein `image` Objekt umschlossen werden.

#### Request Body

| Name            | Type    | Description                                                                                            |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| photo           | string  | base64 encoded String für das Bild                                                                     |
| imageable\_id   | integer | ID des Objektes/Projektes                                                                              |
| imageable\_type | string  | Entweder "Property" oder "Project", je nachdem ob das Bild an ein Objekt oder Projekt angehangen wird. |
| is\_private     | boolean | Wenn `false` => Bild auf Portale anzeigen. Bei `true` => Bild wird nicht zu Portalen übertragen        |
| title           | string  | Bildbeschreibung. Wird auch als Dateiname in der URL verwendet                                         |

{% tabs %}
{% tab title="201 Bild erfolgreich erstellt. ID des Bildes wird zurückgegeben." %}

```javascript
{
  "ok": true,
  "id": 38202
}
```

{% endtab %}
{% endtabs %}

### Beispiel Payload

```javascript
{
  "image": {
    "imageable_id": 12,
    "imageable_type": "Property",
    "photo": "data:image/png;base64,...",
    "title": "Ausblick"
  }
}
```

## Bild bearbeiten

<mark style="color:orange;">`PUT`</mark> `https://api.propstack.de/v1/images/{id}`

#### Request Body

| Name        | Type   | Description                                                                                     |
| ----------- | ------ | ----------------------------------------------------------------------------------------------- |
| title       | String | Bildbeschreibung                                                                                |
| is\_private | String | Wenn `false` => Bild auf Portale anzeigen. Bei `true` => Bild wird nicht zu Portalen übertragen |

### Bild-Beschreibung mehrsprachig bearbeiten

Die Bildbeschreibung ist ein mehrsprachiges Feld, d.h. man kann es in verschiedenen Sprachen befüllen. Über die API geht das, indem man das Feld `title_[locale]` bedient. \[locale] muss mit der jeweiligen Sprache ersetzt werden. Ein Beispiel-Payload um die deutsche und englische Version gleichzeitig zu setzen:

```
{
  "image": {
    "title_de": "Ausblick",
    "title_en": "View"
  }
}
```