OneCatalog API
面向开发者的 OneCatalog 公开 API 文档。本站收录两个 API：
| API | 用途 | 文档覆盖范围 |
|---|---|---|
| Wiki API | 商品、品牌、分类、系列、国家/地区、计量单位、规格和商品类型的参考数据。 | 完整 —— 全部方法。 |
| B2B API | 面向供应商与零售商的 B2B 平台。 | 仅公开的 “按密钥获取价格与库存” 方法（share-products/{url_key}）。其他方法面向授权合作伙伴，不在本文档范围内。 |
基础地址
| API | Base URL |
|---|---|
| Wiki | https://api.onecatalog.net/wiki |
| B2B | https://api.onecatalog.net/b2b |
响应本地化
两个 API 都通过 lang 查询参数支持多语言响应。可用取值：
| 代码 | 语言 |
|---|---|
ru | 俄语（默认） |
en | 英语 |
ar | 阿拉伯语 |
zh | 中文 |
kk | 哈萨克语 |
示例：
curl "https://api.onecatalog.net/wiki/v1/products/?lang=en"
响应中包含 meta.i18n 字段，给出实际应用的语言与回退语言。
鉴权
- Wiki API —— 大多数方法是公开的。如需扩展字段，请在
api-key查询参数或X-API-Key请求头中传入 API 密钥。 - B2B API（公开 share-products） —— 通过价目表的
url_key访问；必要时可通过private_key查询参数传入附加密钥。
响应格式
响应以 JSON 返回。许多 Wiki 方法支持 response_fmt 参数（json、yaml、yml、xml）以及文件导出（is_download=1）。分页使用 start 和 limit。
提示
左侧的 Wiki API 与 B2B API 分区列出了每个方法及其参数、响应模式和请求示例。每个方法都可以直接在文档中发送请求。