Core resources
Standorte
Rufen Sie eine Liste der verfügbaren Standorte ab, an denen Sie Ihre Produkte verkaufen können
Übersicht
Der Endpunkt „Sites“ gibt alle Standorte (Märkte/Regionen) zurück, die für Ihr Lieferantenkonto verfügbar sind. Jeder Standort repräsentiert einen eigenen geografischen Markt auf der Curosa-Plattform. Standort-Codes werden in der gesamten API referenziert, wenn mit Produkten, Preisen und Beständen gearbeitet wird.
Authentifizierung
Dieser Endpunkt erfordert eine Authentifizierung. Geben Sie Ihren API-Token im Authorization-Header an. Weitere Informationen zum Erhalt eines Tokens finden Sie im Leitfaden zur Authentifizierung.
Alle Standorte auflisten
Rufen Sie eine Liste aller für Ihr Konto verfügbaren Standorte ab.
Endpunkt: GET https://curosa.com/api/v1/sites
Anfrage
curl --location 'https://curosa.com/api/v1/sites' \
--header 'Authorization: Bearer YOUR_API_TOKEN'
Antwort
Gibt ein 200 OK mit einem data-Array zurück, das alle für Ihr Konto verfügbaren Standorte enthält:
{
"data": [
{
"code": "UK",
"name": "United Kingdom"
}
]
}
Antwortfelder:
| Feld | Typ | Beschreibung |
|---|---|---|
code |
string | Eindeutiger Identifikator für den Standort. Wird als Referenz in anderen API-Aufrufen verwendet (z. B. "UK") |
name |
string | Anzeigename des Standorts (z. B. "United Kingdom") |
Verwendung von Standort-Codes
Der Wert code aus dem Standort-Objekt wird in der gesamten API als Referenz verwendet. Wenn Sie beispielsweise die Preise für ein Produkt festlegen, referenzieren Sie den Standort über den site_code:
{
"site_pricing": [
{
"site_code": "UK",
"price": "50.00",
"price_currency": "GBP"
}
]
}
Ratenbegrenzung
Dieser Endpunkt ist 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.