Curosa
Supplier Portal API Reference New

Core resources

站点

获取可销售产品的可用站点列表

概览

Sites 接口返回您的供应商账号下所有可用的站点(市场/地区)。每个站点代表 Curosa 平台上一个独特的地理市场。在处理产品、定价和库存时,整个 API 都会引用站点代码。

身份验证

此接口需要进行身份验证。请在 Authorization 请求头中包含您的 API 令牌。有关获取令牌的更多信息,请参阅 身份验证指南

列出所有站点

获取您账号下所有可用的站点列表。

接口: GET https://curosa.com/api/v1/sites

请求

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

响应

返回 200 OK 状态码,并在 data 数组中包含您账号下所有可用的站点:

{
    "data": [
        {
            "code": "UK",
            "name": "United Kingdom"
        }
    ]
}

响应字段:

字段 类型 描述
code string 站点的唯一标识符。在其他 API 调用中作为参考使用(例如 "UK"
name string 站点的显示名称(例如 "United Kingdom"

使用站点代码

站点对象中的 code 值在整个 API 中作为参考使用。例如,在设置产品定价时,您将通过 site_code 引用站点:

{
    "site_pricing": [
        {
            "site_code": "UK",
            "price": "50.00",
            "price_currency": "GBP"
        }
    ]
}

速率限制

此接口的速率限制为每小时 3,600 次请求。当前限制和剩余请求次数将在响应头中作为 x-ratelimit-limitx-ratelimit-remaining 返回。