API-Referenz
Zuletzt aktualisiert: 3. Juli 2026
Diese Referenz ist eine HTTP-API-Spezifikation für Entwickler, die WEEGLOO direkt im Code verwenden. Der Endpunkt-Block auf jeder Ressourcenseite wird als Konsole gerendert, in der Sie Pfad, Header und Body selbst ausfüllen und tatsächlich aufrufen können. So sehen Sie direkt an Ort und Stelle, wie eine Anfrage aussieht und in welcher Form die Antwort zurückkommt.
KI-Agenten rufen diese HTTP-API nicht direkt auf, sondern verwenden die WEEGLOO-MCP-Tools. Die nachstehende Spezifikation ist für den Fall gedacht, dass Sie die API direkt aus Anwendungscode wie Frontend, Backend oder Skripten aufrufen.
API und Base URL
WEEGLOO stellt mehrere nach Verwendungszweck unterteilte APIs bereit. Wählen Sie die zur aufzurufenden API passende Base URL. Raten Sie den Host nicht und verändern Sie ihn nicht.
| API | Verwendung | Base URL |
|---|---|---|
| CMA | Content-Verwaltung (Erstellen, Ändern, Löschen durch Weegloo User) | https://cma.weegloo.com |
| CDA | Auslieferung veröffentlichter Inhalte (nur Lesen, cachebasiert) | https://cda.weegloo.com |
| Upload | Datei-Upload | https://upload.weegloo.com |
| ACMA | Content-Verwaltung für App-Mitglieder (ServiceUser) | https://acma.weegloo.com |
| ACDA | Auslieferung an App-Mitglieder (ServiceUser) (nur Lesen) | https://acda.weegloo.com |
| Auth | OAuth-Anmeldung und Token für ServiceUser | https://auth.weegloo.com |
Pfade basieren auf /v1/.... Beispielsweise lautet die Content-Liste innerhalb eines Space https://cma.weegloo.com/v1/spaces/{spaceId}/contents.
Identität und Token
WEEGLOO verfügt über zwei vollständig voneinander getrennte Identitätssysteme. Welche API aufgerufen werden kann, hängt davon ab, von welcher Identität das Token ausgestellt wurde.
Ein Weegloo User ist ein WEEGLOO-Plattformkonto. Wenn Sie sich zum ersten Mal anmelden (etwa per Social-Login), wird das Konto an Ort und Stelle erstellt (die erste Anmeldung ist zugleich die Registrierung). Um jedoch die Inhalte eines bestimmten Space zu bearbeiten, müssen Sie Mitglied dieses Space sein, und die Mitgliedschaft wird durch die Einladung einer bereits zugehörigen Person und die Zuweisung einer SpaceRole festgelegt. Das Konto selbst können Sie also frei erstellen, doch in welchen Space Sie gelangen und was Sie dort tun dürfen, wird über Mitgliedschaft und Rolle gesteuert. Das Bearer-Token dieser Identität (ein PersonalAccessToken für Server und CI oder ein über die Content-Studio-Anmeldung erhaltenes Token) authentifiziert CMA, Upload und CDA. Für die öffentliche Auslieferung, die im Browser offengelegt wird, verwenden Sie statt des Tokens ein DeliveryAccessToken (CDA) mit auf das Minimum eingeschränkten Berechtigungen.
ServiceUser sind End-User, die sich beim Produkt registriert haben (Registrierung über ServiceLogin). Wem die Registrierung offensteht und ob für Neuregistrierungen eine Administrator-Freigabe erforderlich ist, wird über die Einstellungen von ServiceLogin festgelegt. Das Bearer-Token dieser Identität (ausgestellt von auth.weegloo.com) authentifiziert ACMA und ACDA sowie Upload. Für CMA und CDA kann es nicht verwendet werden.
Token überschreiten keine Identitätsgrenzen. Ein ServiceUser-Token darf nicht an CMA oder CDA gesendet werden, und ein Weegloo-User-Token ist kein gültiger Aufrufer für ACMA oder ACDA. Die einzige von beiden Identitäten gemeinsam genutzte Oberfläche ist Upload. Wo nach dem Upload das Media erstellt wird, unterscheidet sich je nach Identität: CMA (Weegloo User) oder ACMA (ServiceUser).
Gemeinsame Konventionen
Die folgenden vier Punkte sind nicht auf eine bestimmte Ressource beschränkt, sondern gelten gemeinsam für alle Aufrufe. Die einzelnen Ressourcenseiten setzen diese Konventionen voraus und behandeln nur die jeweils spezifischen Inhalte.
- Systemeigenschaften (sys): Struktur der
sys-Metadaten jeder Ressource (id,version,Refer, Veröffentlichungsstatus). - Gemeinsame Query-Parameter: Listenabfrage (
limit,order,filter) und cursorbasierte Paginierung. - Konventionen: Antwort-Medientyp, partielle Änderung (JSON Patch), Nebenläufigkeitskontrolle (
X-Weegloo-Version). - Fehler: Format der Fehlerantworten und gemeinsame Codes.
Ressourcenreferenz
Die Ressourcenspezifikationen je API werden in den nachstehenden Hubs behandelt.
- CMA: Content-Modellierung und -Verwaltung: Content Type, Content, Media, Tag, Locale sowie Verwaltungsressourcen wie Token, Organisation, Space, Rollen, Webhook, WebHosting, ServiceLogin.
- CDA: Auslieferung: Auslieferung veröffentlichter Inhalte im Nur-Lese-Modus.
- Upload: Dateien hochladen und das Upload erhalten, das zur Erstellung von Media und WebHosting dient.
- Auth: ServiceUser-OAuth-Anmeldung und Token-Austausch.
- ACMA: Content-Verwaltung für App-Mitglieder (ServiceUser).
- ACDA: Auslieferung veröffentlichter Inhalte an App-Mitglieder (ServiceUser).