diff --git a/DELETE-%2Fdns%2Fzones%2F%7Bdomain%7D%2Frecords.md b/DELETE-%2Fdns%2Fzones%2F%7Bdomain%7D%2Frecords.md new file mode 100644 index 0000000..6a6ceac --- /dev/null +++ b/DELETE-%2Fdns%2Fzones%2F%7Bdomain%7D%2Frecords.md @@ -0,0 +1,87 @@ +## **DELETE /dns/zones/{domain}/records** + + +## **Inhalt** +--- +- Parameter +- Optionale Parameter +- Beispiel Anfrage +- Beispiel Antwort +- Mögliche Fehlermeldungen +--- + +### Parameter + +|URL Parameter | Typ | Beschreibung| +|----------|-----|-------------| +|domain | string | Die Domain dessen Records verändert werden sollen + +|Body Parameter | Typ | Beschreibung| +|----------|-----|-------------| +| - | - | - | + + +--- + +### Optionale Parameter + +|Query-String Parameter | Typ | Beschreibung| +|----------|-----|-------------| +| - | - | -| + +--- + +### Beispiel Anfrage + +##### PHP +```php + 'control.local/api/v2/dns/zones/domain1.de/records', + CURLOPT_CUSTOMREQUEST => 'PUT', + CURLOPT_POSTFIELDS =>'{ + "name": "test22.domain1.de.", + "type": "A" + }', + 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 PUT 'control.local/api/v2/dns/zones/domain1.de/records' \ +--header 'X-TOKEN: test-token' \ +--header 'Content-Type: application/json' \ +--data-raw '{ + "name": "test22.domain1.de.", + "type": "A" +}' +``` + +--- + +### Beispiel Antwort + +```json +{ + "status": "OK" +} +``` + +### Mögliche Fehlermeldungen + + +> :warning: Status Code **400** - Formatting Error + +> :warning: Status Code **403** - Permission denied