# HTTP Webhook

## Introduction

Our HTTP Webhook module allows you to integrate any type of custom service. The module sends a POST request to the URLs you have configured, and provisioning can then be handled entirely by your service.

When configured, the module sends an HTTP Authorization Bearer Token with each request.

## Installation

None

## Alle Requests von dem Modul:

Methode: POST\
Payload: 

| Schlüssel      | Beschreibung                                           |
| -------------- | ------------------------------------------------------ |
| productHosting | ProductHosting-Objekt                                  |
| event          | Das Event, z.B. create, lock, unlock, delete,          |
| options        | Nur bei create, ein assoc-Array mit den Produktoptione |

Die create-Response von der API wird in dem Hosting gespeichert. Sollte die JSON-Response den Schlüssel "message" enthalten, wird diese gelogged und in der Administration angezeigt.

### Request-Besonderheit: Status Abfrage

Methode: GET (!)\
Erwartete Rückgabe: JSON Response mit den Schlüsseln: 

| Schlüssel    | Beschreibung                                                                                |
| ------------ | ------------------------------------------------------------------------------------------- |
| statusString | Der String, der im Kundenbereich angezeigt wird. z.B. "Online" oder "Offline"               |
| badgeColor   | Die Bootstrap-Farbe der Badge, die angezeigt wird. z.B. "danger" oder "success"             |
| additional   | Optional - Zusätzliche Daten im Array-Format, welche in der Storefront zur Verfügung stehen |

Wenn statusString nicht definiert ist, wird standardmäßig der Status "Aktiv" in grüner Farbe zurückgegeben.

### Request-Besonderheit: Overview Abfrage

Methode: GET (!)\
Erwartete Rückgabe: JSON Response mit den Schlüsseln: 

| Schlüssel | Beschreibung                                                                  |
| --------- | ----------------------------------------------------------------------------- |
| html      | HTML, welches auf der Übersicht des Hostings im Kundenbereich angezeigt wird. |

Wenn html nicht definiert ist, wird im Kundenbereich nichts angezeigt.