AIOSEO-Daten über die WordPress REST API abrufen und aktualisieren

Das REST API-Addon (eingeführt mit AIOSEO 4.1.9) ist für alle Benutzer der Plus-, Pro- und Elite-Pläne verfügbar und ermöglicht es Ihnen, AIOSEO-Daten einfach über die REST API abzurufen und zu aktualisieren.

Dies kann besonders nützlich sein, wenn Sie zum Beispiel Folgendes haben:

  • Eine Headless-WordPress-Site, auf der Sie Ihre SEO-Daten manuell im Frontend ausgeben müssen;
  • Ein Drittanbieter-System zur Verwaltung Ihrer Beiträge (z. B. eCommerce ERP mit WooCommerce-Integration), und Sie möchten Ihre SEO-Daten über dieses System verwalten können.

Nachfolgend erklären wir, welche Daten über die REST API verfügbar sind und wie Sie diese aktualisieren können.

Daten abrufen

Anstatt benutzerdefinierte Endpunkte zu registrieren, integriert sich das REST API-Addon in die Standardendpunkte des WordPress-Kerns. Derzeit werden alle GET-Routen für Beiträge und Begriffe unterstützt.

Dazu gehören:

  • /wp/v2/posts
  • /wp/v2/pages
  • /wp/v2/media
  • /wp/v2/categories
  • /wp/v2/tags

Und auch alle Routen für benutzerdefinierte Beitragstypen und benutzerdefinierte Taxonomien auf Ihrer Website, die die REST API unterstützen.

Die folgenden Felder werden in der Antwort dieser Routen enthalten sein:

aioseo_head

Dieses Feld enthält die rohen SEO-Daten, die normalerweise von All in One SEO in den Quellcode Ihres Beitrags/Begriffs als Textzeichenfolge ausgegeben würden.

Wenn Sie eine Headless-WordPress-Website haben, können Sie diese Daten direkt in den Quellcode des Frontends Ihrer Installation ausgeben.

aioseo_head_json

Dieses Feld enthält die gleichen Werte wie die aioseo_head-Daten (siehe oben), jedoch im JSON-Format.

Dies ermöglicht es Ihnen, die Daten einfach zu filtern, bevor Sie sie in den Quellcode ausgeben oder für einen anderen Zweck verwenden.

Bitte beachten Sie, dass diese Daten keinen HTML-Code für die Meta-Tags enthalten, für die diese Werte verwendet werden. Sie müssen diese also selbst erstellen.

aioseo_meta_data

Dieses Feld enthält die Daten, die in den benutzerdefinierten Beitrags- und Begriffstabellen von AIOSEO im JSON-Format gespeichert sind.

Diese Daten sollten hauptsächlich verwendet werden, wenn Sie die vorhandenen Daten bearbeiten und dann auf Ihrer Website aktualisieren möchten.

Daten aktualisieren

Um Daten über die REST API zu aktualisieren, müssen Sie sich authentifizieren. Wenn Sie unsicher sind, wie das geht, lesen Sie bitte die Dokumentation der WordPress REST API.

Der Benutzer, mit dem Sie sich authentifiziert haben, muss außerdem eine der folgenden Berechtigungen besitzen, um AIOSEO-Daten über die REST API aktualisieren zu können:

  • aioseo_page_general_settings
  • aioseo_page_social_settings
  • aioseo_page_schema_settings
  • aioseo_page_advanced_settings

Sobald Sie diese Anforderungen erfüllt haben, können Sie Daten über eine POST/PUT-Anforderung aktualisieren, indem Sie die Eigenschaft aioseo_meta_data im Body der Anforderung hinzufügen.

Innerhalb dieser Eigenschaft können Sie alle Schlüssel angeben, die im Feld aioseo_meta_data enthalten sind (siehe oben), zusammen mit dem neuen Wert.

Unten sehen Sie ein Beispiel, wie dies aussieht:

{
	"aioseo_meta_data": {
		"title":"NEW TITLE",
		"description":"NEW DESCRIPTION"
	}
}

Wenn Sie spezielle Fragen zur REST-API haben, wenden Sie sich bitte an unser Support-Team. Wir helfen Ihnen gerne weiter.