From 2c695fbe8ac46377e0300c73a85e95522375832c Mon Sep 17 00:00:00 2001 From: Thomas Brinkmann Date: Wed, 1 Jun 2022 18:50:08 +0200 Subject: [PATCH] =?UTF-8?q?=E2=80=9EDELETE=20/service/{serviceid}=E2=80=9C?= =?UTF-8?q?=20=C3=A4ndern?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DELETE-%2Fservice%2F%7Bserviceid%7D.md | 78 ++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 DELETE-%2Fservice%2F%7Bserviceid%7D.md diff --git a/DELETE-%2Fservice%2F%7Bserviceid%7D.md b/DELETE-%2Fservice%2F%7Bserviceid%7D.md new file mode 100644 index 0000000..1482cf8 --- /dev/null +++ b/DELETE-%2Fservice%2F%7Bserviceid%7D.md @@ -0,0 +1,78 @@ +## **DELETE /service/{serviceid}** + + +## **Inhalt** +--- +- Parameter +- Optionale Parameter +- Beispiel Anfrage +- Beispiel Antwort +- Mögliche Fehlermeldungen +--- + +### Parameter + +|URL Parameter | Typ | Beschreibung| +|----------|-----|-------------| +|serviceid | integer| Beschreibt die ID des Services + +|Body Parameter | Typ | Beschreibung| +|----------|-----|-------------| +| - | - | - | + + +--- + +### Optionale Parameter + +|Query-String Parameter | Typ | Beschreibung| +|----------|-----|-------------| +|- | -| - + +--- + +### Beispiel Anfrage + +##### PHP +```php + 'control.local/api/v2/service/12345', + CURLOPT_CUSTOMREQUEST => 'DELETE', + CURLOPT_HTTPHEADER => array( + 'X-TOKEN: test-token', + 'Content-Type: application/json' + ), +)); + +$response = curl_exec($curl); + +curl_close($curl); +echo $response; +``` + +##### cURL +```bash +curl --location --request DELETE 'control.local/api/v2/service/12345' \ +--header 'X-TOKEN: test-token' \ +--header 'Content-Type: application/json' +``` + +--- + +### Beispiel Antwort + +```json +{ + "status": "OK" +} +``` + +### Mögliche Fehlermeldungen + +> :warning: Status Code **403** - Permission denied + +> :warning: Status Code **500** - Cancellation request could not been set \ No newline at end of file