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-limit 和 x-ratelimit-remaining 返回。