API | pixx.io

01 Grundlagen

Was ist eine REST-API?

Eine API (Application Programming Interface) ist eine Schnittstelle aus klar definierten HTTP-Aufrufen, über die zwei Systeme Daten austauschen — ganz ohne Benutzeroberfläche und ohne manuellen Klick. Statt dich in pixx.io einzuloggen und Dateien per Hand zu bearbeiten, schickt dein eigenes Programm einen Request wie „gib mir alle Dateien mit dem Schlagwort Sommer" oder „setze bei Datei 48213 den Status auf freigegeben" — und bekommt eine strukturierte Antwort zurück.

Die vier gängigen HTTP-Methoden decken dabei fast alles ab: GET zum Lesen, POST zum Erstellen, PUT zum Aktualisieren, DELETE zum Löschen.

02 Möglichkeiten

Was kannst du damit machen?

Die pixx.io API deckt praktisch jedes Objekt im Mediaspace ab:

Dateien

Hochladen, suchen, herunterladen, Metadaten lesen und schreiben, Versionen verwalten.

Sammlungen & Freigaben

Collections anlegen und pflegen, externe Freigaben (Share-Links) erstellen und verwalten.

Rechte & Nutzer

Rechtegruppen, Benutzerkonten und Berechtigungen zentral steuern.

Lizenzen & Releases

Lizenz-, Model- und Property-Releases verwalten und Ablaufdaten prüfen.

Downloads & Formate

Vordefinierte Download-Formate (Renditions) und Direktlinks abrufen.

Schlagworte & Synonyme

Keyword- und Synonym-Verwaltung für eine konsistente Verschlagwortung.

Typische Einsatzszenarien: automatischer Bildimport aus einem PIM/ERP, Metadaten-Sync mit einem Shop- oder CMS-System, Reporting über eigene Dashboards, oder das Zurückschreiben von KI-generierten Ergebnissen aus einer Automatisierung.

03 Zugang

Authentifizierung

Der Zugriff erfolgt über persönliche API-Keys, die du mit einem definierten Scope anlegst, einem Nutzer zuordnest und optional auf einen bestimmten IP-Bereich beschränken kannst. So behältst du auch bei mehreren Integrationen den Überblick, welcher Key wofür genutzt wird — und kannst einzelne Keys jederzeit deaktivieren, ohne andere Integrationen zu beeinträchtigen.

bash · curl

curl "https://<deineMediaspaceUrl>/..." \
  -H "Authorization: Bearer DEIN_API_KEY"

Exakte Endpunkte, Parameter und das genaue Authentifizierungs-Schema findest du verbindlich in der offiziellen API-Dokumentation — dieser Curl-Aufruf zeigt nur das Grundprinzip.

04 Zusammenspiel

API + Webhooks: der vollständige Kreislauf

Ein Webhook allein liefert nur Informationen — die eigentliche Automatisierung entsteht erst im Zusammenspiel mit der API. Der Webhook sagt dir „das ist gerade passiert", die API lässt dich reagieren: Datei nachladen, Metadaten aktualisieren, Ergebnis zurückschreiben.

🔁

Push (Webhook) informiert dich in Echtzeit. Pull & Write (API) lässt dich lesen und verändern. Die meisten Integrationen brauchen beides. Details dazu in der Webhook-Dokumentation und der Automatisierungs-Übersicht.

Bereit für die erste Anfrage?

Alle Endpunkte, Parameter und Beispiel-Requests findest du in der vollständigen API-Referenz.

Zur API-Dokumentation → Webhooks Automatisierung Plugin SDK