🌐 基础URL:http://api.metaverseasset.vip/
X-API-Key: your-api-keyapi_key=your-api-key
获取商品分类列表,支持树形结构和扁平列表两种格式。
返回的分类名称会根据 lang 参数自动切换语言。
GET /categories.php
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| api_key | string | 是 | 无 | API Key(测试时已内置) |
| lang | string | 否 | zh | 语言代码(见下方支持的语言列表) |
| format | string | 否 | tree | 输出格式:tree(树形)或 list(扁平列表) |
获取商品列表,支持分页、状态筛选、分类筛选和多语言关键词搜索。
返回每个商品的完整多语言块,包含分类信息。
GET /products.php
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| api_key | string | 是 | 无 | API Key(测试时已内置) |
| page | int | 否 | 1 | 页码 |
| limit | int | 否 | 20 | 每页数量,最大100 |
| status | int | 否 | 1 | 状态:1上架 0下架 |
| category_id | int | 否 | 0 | 分类ID(从分类列表获取),0表示全部 |
| keyword | string | 否 | 空 | 搜索关键词 |
| lang | string | 否 | 空 | 指定搜索语言(见下方支持的语言列表) 不传则返回所有语言 |
获取单个商品的完整详细信息,包含完整多语言块、分类信息、规格参数等。
GET /product_detail.php
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| api_key | string | 是 | 无 | API Key(测试时已内置) |
| id | int | 是 | 无 | 商品ID |
以下为系统支持的所有语言代码,可在 lang 参数中使用。
以下为现有的分类,前端可用于构建下拉选择器或导航菜单。
叶子节点 表示该分类下可直接挂载商品。
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 0 | 成功 | - |
| 401 | 未授权 | 检查 API Key 是否正确或是否已启用 |
| 400 | 参数错误 | 检查请求参数是否正确 |
| 404 | 商品不存在 | 检查商品ID是否正确 |
| 500 | 服务器错误 | 联系技术支持 |