Eine Kategorie löschen

Kategorie löschen

Das Löschen einer Kategorie erfolgt durch Senden einer DELETE-Anfrage an den Endpoint /categories/:id.

Ein API-Key mit Scope kann keine Kategorie löschen, die einer seiner Scope-Anker ist. Siehe Authentifizierung.

CURL


curl -X DELETE https://app.ignitevideo.cloud/api/categories/[CATEGORY_ID] \ 
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \

JavaScript / Node.js


const response = await fetch(`https://app.ignitevideo.cloud/api/categories/[CATEGORY_ID]`, {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer YOUR_TOKEN`,
  }
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('DELETE', 'https://app.ignitevideo.cloud/api/categories/[CATEGORY_ID]', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_TOKEN',
  ]
]);

Antwort

Die Antwort ist das gelöschte Kategorie-Objekt mit einer Statusmeldung. Wenn die Id nicht existiert, ist die Antwort 403 mit dem Payload-Fehler. Eine fehlende Id und eine verbotene Id liefern denselben Body. Siehe Authentifizierung.


{
  doc: {
    "id": "[CATEGORY_ID]",
    "title": "Category title",
    "slug": "category-slug"
  },
  message: "Deleted successfully."
}