Wir bereiten die neuesten Anleitungen, Releases und Feature-Updates vor.
Anleitungen werden geladen
Wir bereiten die passenden Inhalte der Wissensdatenbank für diese Plattform vor.
REST-API-Endpunkte (chamevo/v1) | Chamevo Support Center
REST-API-Endpunkte (chamevo/v1)
Referenz für die Chamevo WordPress REST API — Authentifizierung, Bestellungen, Produkte, Ansichten und Asset-Endpunkte.
Aktualisiert am 29. April 20265 Min. Lesezeit
Chamevo registriert REST-API-Endpunkte unter dem Namespace chamevo/v1. Verwenden Sie diese Endpunkte, um Produkte und Ansichten programmgesteuert zu verwalten, Assets hochzuladen, Bestellungs-Personalisierungsdaten abzurufen und Print-Ready-File-Benachrichtigungen zu empfangen.
Authentifizierung
Alle geschützten Endpunkte erfordern ein Bearer-Token im Authorization-Header.
Authorization: Bearer YOUR_API_TOKEN
Chamevo generiert automatisch ein 64-Zeichen-hexadezimales Token und speichert es in der WordPress-Option chamevo_api_token. Das Token kann nicht manuell geändert werden. So rufen Sie es in PHP ab:
$token = get_option('chamevo_api_token');
Token in der Administration anzeigen
Navigieren Sie zu Chamevo → Settings → API. Das Feld API Token zeigt das aktuelle Token an. Das Feld ist schreibgeschützt — kopieren Sie den Wert direkt von dort in Ihren API-Client oder Ihre MCP-Server-Konfiguration.
Das Token wird automatisch von Chamevo generiert und kann nicht manuell geändert werden.
Ein Bild (PNG, JPEG, SVG) oder PDF in den Chamevo-Upload-Ordner hochladen.
Authentifizierung: Bearer-Token erforderlich.
Erforderlich: Assets API in Settings → API aktiviert.
Anfrage: Multipart-Formulardaten mit einem file-Feld.
Der Upload durchläuft dieselbe Sicherheitspipeline wie der Standard-AJAX-Upload-Handler: MIME-Typ-Validierung, finfo-Überprüfung zur Verhinderung von Erweiterungsfälschungen, Bild-Re-Encoding zum Entfernen eingebetteter Payloads, EXIF-Orientierungskorrektur für JPEG-Dateien, SVG-Bereinigung und StorageManager-Push (lädt auf S3 oder Dropbox hoch, sofern konfiguriert).
Die maximale Dateigröße wird durch Maximum Image Size in den Print-Profil-Upload-Einstellungen gesteuert (Standard 10 MB).
Empfängt Print-Ready-File-Benachrichtigungen vom Chamevo Service Router. Wenn eine druckfertige Datei in der Cloud generiert wird, ruft der Service Router diesen Endpunkt auf.
Authentifizierung: Keine (öffentlicher Endpunkt).
URL-Parameter:
Parameter
Typ
Erforderlich
Beschreibung
id
string
Ja
Die Print-Job-Kennung
Body-Parameter:
Parameter
Typ
Beschreibung
print_job_id
string
GUID zur Identifizierung dieses Print-Jobs
file_url
string
URL der generierten druckfertigen Datei
Verhalten:
Sucht den Print-Job anhand der GUID in der fpd_print_jobs-Tabelle.
Lädt die Datei herunter und speichert sie in wp-content/chamevo/print_files/.
Wenn dem Print-Job eine Printful-Variante zugeordnet ist, erstellt oder aktualisiert er eine Printful-Bestellung.
Wenn keine Printful-Variante zugeordnet ist, markiert er den Print-Job als completed.
Dieser Endpunkt wird vom Chamevo Service Router aufgerufen. Um ihn in einer benutzerdefinierten Integration zu verwenden, konfigurieren Sie die Webhook-URL unter Chamevo → Settings → Export → Webhook URL.
Rate-Limiting
Chamevo fügt der REST API kein Rate-Limiting hinzu. Standard-WordPress- und Server-seitige Limits gelten.
FAQ
F: Wo finde ich mein API-Token?
A: Navigieren Sie zu Chamevo → Settings → API. Das Feld API Token zeigt das aktuelle Token an. Kopieren Sie es direkt von dort — bearbeiten Sie es nicht.
F: Kann ich bestimmte Endpunktgruppen deaktivieren?
A: Ja. Die Umschalter Products API und Assets API unter Chamevo → Settings → API ermöglichen es Ihnen, jede Gruppe unabhängig zu deaktivieren. Der Orders-Endpunkt ist immer aktiv.
F: Welche Dateitypen kann ich über die Assets API hochladen?
A: PNG, JPEG, SVG und PDF. Es gelten dieselben Größen- und MIME-Typ-Regeln wie für den Standard-Upload-Handler.
