REST-APIeasy-svg-pro/v1/sets/{id}

easy-svg-pro/v1/sets/{id}

Liest ein Icon-Set oder ersetzt alle seine Icons in einem Schreibvorgang.

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

GET|POST /wp-json/easy-svg-pro/v1/sets/{id}

Beispiel

curl -u admin:app-password -H 'Content-Type: application/json' -d '{"icons":[{"slug":"arrow","label":"Arrow","markup":"<svg viewBox="0 0 24 24"><path d="M2 12h20"/></svg>"}]}' https://example.com/wp-json/easy-svg-pro/v1/sets/42

Beschreibung

GET liefert das Set mit seinem registrierten Collection-Slug. Der kann auf älteren Sites um ein -x vom Post-Slug abweichen. POST ersetzt das ganze Set: Jedes Icon wird bereinigt und gehärtet, und ein Icon, das im Body fehlt, wird entfernt. Schick icons als Map mit dem Slug als Schlüssel oder als Liste von {slug, label, markup}. Ein nicht leeres label benennt das Set zusätzlich um. Fehler: 404 easy_svg_pro_no_set, 409 easy_svg_pro_no_sanitizer oder easy_svg_pro_no_hardener, wenn das Gratis-Plugin fehlt oder zu alt ist. Berechtigung: Braucht manage_options, eine aktive Lizenz und die eingeschaltete Funktion Icon-Set-Editor (editor).

Parameter

path
idinteger
Required

Die Post-ID des Icon-Sets.

body
iconsobject|array

Nur POST. Alle Icons, die das Set danach enthalten soll. Ein fehlendes Icon wird entfernt.

body
labelstring

Nur POST. Der neue Name des Sets. Fehlt er oder ist er leer, bleibt der alte.

Rückgabewert

returnWP_REST_Response|WP_Error

GET: id, slug (der registrierte Collection-Slug), label und icons als Liste von {slug, label, markup}, nach Slug sortiert. POST: id, icons und saved, die Zahl der gespeicherten Icons.

Antwort

{
  "id": 42,
  "slug": "acme",
  "label": "ACME",
  "icons": [
    {
      "slug": "arrow",
      "label": "Arrow",
      "markup": "<svg ...></svg>"
    }
  ]
}
POST ersetzt das Set. Nimm /sets/{id}/icons/add oder /icons/remove, wenn du nur einen Teil kennst, sonst löschst du den Rest.

Siehe auch