Loading / 加载中…
Loading / 加载中…
电商与交易平台数据
本 API 以 JSON 返回 1stDibs 上的家具、灯具、艺术品、珠宝、腕表和时装商品。你可以按关键词或类目路径加上筛选 slug 进行搜索，查询某个范围内存在哪些筛选 slug 与子类目，获取单件商品或以逗号分隔的多达 10 件商品的完整记录，并分页浏览单个经销商的店铺。价格为经销商的美元标价。
正在核对当前可用状态与已批准价格…
JSON 输入，结构化响应。公共网关端点统一使用 POST。
返回一个商品链接或以逗号分隔的多达 10 个商品 id 的完整记录，包括品相、材质、运费报价以及价格交叉核对标记。
POST /api/v1/firstdibs/post-1stdibs-detail使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"item": "f_52078502"
}
}返回某个关键词或类目范围下的筛选维度，含选项 slug 与数量，以及该层级的子类目。
POST /api/v1/firstdibs/post-1stdibs-filters使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"category": "furniture/seating/lounge-chairs"
}
}按关键词或类目路径返回分页商品行，可用 slug 筛选、美元价格区间、促销状态和排序方式缩小范围。
POST /api/v1/firstdibs/post-1stdibs-search使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"category": "furniture/seating/lounge-chairs",
"max_results": 10
}
}返回单个经销商的资料数据，以及该经销商商品的分页列表，行结构与商品搜索相同。
POST /api/v1/firstdibs/post-1stdibs-seller使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"max_results": 10,
"seller": "morentz"
}
}POST /api/v1/<project>/<action>，并携带 x-api-key、Content-Type: application/json 和必需的 Idempotency-Key。data 是操作的结果。用你准备搜索的同一关键词或类目路径调用筛选项操作。它会返回该范围内的筛选维度及其选项 slug 和数量；在存在对应参数时，维度名称就是它所对应的搜索参数名。
卖家未公开价格的商品行会返回空价格，价格状态为询价，而不会是零。请把它当作未知价格，而不是免费。
可以。详情操作的 item 字段接受多达 10 个以逗号分隔的商品 id，或 1stdibs.com 商品链接。响应会列出哪些请求的 id 已找到、哪些缺失。
origin 是作品的制造地，location 是经销商的发货地。对于由纽约经销商出售的意大利制造椅子，前者对应 italian 这类 slug，后者对应 new-york-usa 这类纽约 slug。