REST-APIeasy-svg-pro/v1/audit/clean

easy-svg-pro/v1/audit/clean

Bereinigt einen SVG-Anhang direkt in der Datei, nachdem das Original gesichert ist.

REST-Endpunkt · Easy SVG Pro · Status: Intern · Definiert in includes/core/rest.php

Intern: nicht Teil der zugesicherten öffentlichen Schnittstelle. Kann sich ohne Ankündigung ändern.

Verwendung

POST /wp-json/easy-svg-pro/v1/audit/clean

Beispiel

curl -u admin:app-password -H 'Content-Type: application/json' -d '{"attachment":101}' https://example.com/wp-json/easy-svg-pro/v1/audit/clean

Beschreibung

Der Anhang muss image/svg+xml sein, und seine Datei muss im Upload-Ordner liegen, sonst kommt 400 easy_svg_pro_not_svg oder easy_svg_pro_outside_uploads. Die unveränderten Bytes werden am Anhang gespeichert und zurückgelesen, bevor die Datei neu geschrieben wird. Klappt das nicht, wird nichts geschrieben, und state ist backup_failed. Es bleibt immer nur das erste Original. Eine bereinigte oder schon saubere Datei verschwindet aus dem gespeicherten Bericht. Berechtigung: Braucht manage_options, eine aktive Lizenz und die eingeschaltete Funktion SVG-Cleaner (audit).

Parameter

body
attachmentinteger
Required

Die ID des Anhangs, der bereinigt wird, mindestens 1.

Rückgabewert

returnWP_REST_Response|WP_Error

state: cleaned (mit removed_tags und removed_attributes), already_clean, refused_malformed, refused_too_large, unreadable, backup_failed oder write_failed.

Antwort

{
  "state": "cleaned",
  "removed_tags": [
    "script"
  ],
  "removed_attributes": [
    "onload"
  ]
}
Das Bereinigen schreibt die Datei in uploads neu. Bereinigen verliert absichtlich etwas, Animationen oder Skripte, auf die ein Designer gesetzt hat, sind weg. Das gesicherte Original ist der Weg zurück.

Siehe auch