REST-APIeasy-svg/v1/library/add

easy-svg/v1/library/add

Fügt ein Icon aus SVG-Markup hinzu, beim Speichern bereinigt und gehärtet.

REST-Endpunkt · Easy SVG · Status: Intern · Definiert in includes/panel.php

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

Verwendung

POST /wp-json/easy-svg/v1/library/add

Beispiel

curl -X POST https://example.com/wp-json/easy-svg/v1/library/add \
	-H 'Content-Type: application/json' \
	-H 'X-WP-Nonce: <nonce>' \
	-d '{"label":"Heart","markup":"<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M0 0h24v24H0z"/></svg>"}'

Beschreibung

Das Label wird als Text bereinigt und wird zum Slug. Ist der Slug vergeben, kommt eine Zahl dazu, und added.wanted zeigt, was gewünscht war. Das Markup durchläuft denselben Sanitizer und dieselben Größen- und Komplexitätsgrenzen wie ein Upload. Ablehnungen antworten mit 422 easy_svg_add_failed und einem Satz aus easy_svg_panel_add_message().

Parameter

body
labelstring

Der sichtbare Name. Der Slug wird daraus abgeleitet und ändert sich nie. Ohne Namen scheitert das Hinzufügen mit bad_name.

Antwort

{
  "items": [
    {
      "id": 42,
      "slug": "heart",
      "label": "Heart",
      "content": "<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 21l-8-8a5 5 0 0 1 8-6 5 5 0 0 1 8 6z"/></svg>"
    }
  ],
  "total": 1,
  "truncated": false,
  "added": {
    "id": 42,
    "slug": "heart",
    "wanted": "heart"
  }
}
Der Handler liest nur den JSON-Body, schick also Content-Type: application/json. Werte im Query-String ignoriert der Handler.

Siehe auch