Marken

Übersicht

Der Brands-Endpunkt ermöglicht es Ihnen, die mit Ihren Produkten verknüpften Marken zu erstellen und zu verwalten. Wenn Sie ein Produkt erstellen, referenzieren Sie eine Marke über ihren Namen. Marken können auch ein optionales Bild tragen, wie z. B. ein Logo, das neben Ihren Produkten auf der Plattform angezeigt werden kann.

Authentifizierung

Alle Endpunkte erfordern eine Authentifizierung. Geben Sie Ihren API-Token im Authorization-Header an. Weitere Informationen zum Erhalt eines Tokens finden Sie im Leitfaden zur Authentifizierung.

---

Alle Marken auflisten

Rufen Sie eine Liste aller mit Ihrem Konto verknüpften Marken ab.

Endpunkt: GET https://curosa.com/api/v1/brands

Anfrage

curl --location 'https://curosa.com/api/v1/brands' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Antwort

Gibt ein 200 OK mit einem data-Array zurück, das alle Marken enthält:

{
    "data": [
        {
            "id": 1,
            "name": "Demo Brand",
            "description": "A brand used for demo purposes",
            "image": null
        }
    ]
}

Antwortfelder:

Feld	Typ	Beschreibung
id	integer	Eindeutige Kennung der Marke
name	string	Anzeigename der Marke
description	string|null	Optionale Beschreibung der Marke
image	string|null	URL des Markenbildes (z. B. ein Logo) oder null, falls nicht gesetzt

---

Eine Marke erstellen

Erstellen Sie eine neue Marke.

Endpunkt: POST https://curosa.com/api/v1/brands

Anfrage

curl --location 'https://curosa.com/api/v1/brands' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Demo Brand",
    "description": "A brand used for demo purposes"
}'

Anfrage-Body:

Feld	Typ	Erforderlich	Beschreibung
name	string	Ja	Anzeigename der Marke
description	string	Nein	Optionale Beschreibung der Marke

Antwort

Gibt bei Erfolg ein 201 Created zurück:

{
    "message": "Brand created successfully",
    "brand_id": 3,
    "name": "Demo Brand",
    "description": "A brand used for demo purposes",
    "image": null
}

---

Eine Marke aktualisieren

Aktualisieren Sie eine bestehende Marke anhand ihrer ID.

Endpunkt: PUT https://curosa.com/api/v1/brands/{id}

Anfrage

curl --location --request PUT 'https://curosa.com/api/v1/brands/3' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Updated Brand Name",
    "description": "Updated description"
}'

Pfad-Parameter:

Parameter	Typ	Beschreibung
id	integer	Die ID der zu aktualisierenden Marke

Anfrage-Body:

Feld	Typ	Erforderlich	Beschreibung
name	string	Ja	Aktualisierter Anzeigename der Marke
description	string	Nein	Aktualisierte Beschreibung der Marke

---

Eine Marke löschen

Löschen Sie eine Marke anhand ihrer ID.

Endpunkt: DELETE https://curosa.com/api/v1/brands/{id}

Anfrage

curl --location --request DELETE 'https://curosa.com/api/v1/brands/3' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Pfad-Parameter:

Parameter	Typ	Beschreibung
id	integer	Die ID der zu löschenden Marke

---

Marken mit Produkten verwenden

Wenn Sie ein Produkt erstellen, referenzieren Sie die Marke über ihren Namen (name):

{
    "sku": "DEMO001",
    "name": "Demo Product",
    "brand": "Demo Brand"
}

Ratenbegrenzung

Alle Marken-Endpunkte sind auf 3.600 Anfragen pro Stunde begrenzt. Das aktuelle Limit und die verbleibenden Anfragen werden in den Antwort-Headern als x-ratelimit-limit und x-ratelimit-remaining zurückgegeben.