📦 商品API接口文档

海外电商商品系统 · 多语言支持 · RESTful API
💬 联系客服

🌐 基础URL:http://api.metaverseasset.vip/

🔑 认证 所有接口需要携带 API Key
方式一(推荐):请求头 X-API-Key: your-api-key
方式二(测试):GET 参数 api_key=your-api-key

💡 下方测试功能已内置 Key,点击 🚀 发送请求 即可测试 测试KEY无法在正常环境使用
GET /categories.php 需认证 公开 分类 树形

📋 功能描述

获取商品分类列表,支持树形结构和扁平列表两种格式。
返回的分类名称会根据 lang 参数自动切换语言。

🔗 请求方式

GET /categories.php

📌 请求参数

参数名类型必填默认值说明
api_keystring是无API Key(测试时已内置)
langstring否zh语言代码(见下方支持的语言列表)
formatstring否tree输出格式:tree(树形)或 list(扁平列表)

📥 请求示例

// 获取树形分类(中文) GET /categories.php?api_key=YOUR_API_KEY&lang=zh // 获取扁平分类列表(英文) GET /categories.php?api_key=YOUR_API_KEY&lang=en&format=list

🧪 在线测试

(已内置)
/categories.php?api_key=****&lang=zh
GET /products.php 需认证 公开 分页 筛选 分类搜索

📋 功能描述

获取商品列表,支持分页、状态筛选、分类筛选和多语言关键词搜索。
返回每个商品的完整多语言块,包含分类信息。

🔗 请求方式

GET /products.php

📌 请求参数

参数名类型必填默认值说明
api_keystring是无API Key(测试时已内置)
pageint否1页码
limitint否20每页数量,最大100
statusint否1状态:1上架 0下架
category_idint否0分类ID(从分类列表获取),0表示全部
keywordstring否空搜索关键词
langstring否空指定搜索语言(见下方支持的语言列表)
不传则返回所有语言

📥 请求示例

// 按分类搜索(查询分类ID=20101的商品) GET /products.php?api_key=YOUR_API_KEY&category_id=20101&lang=zh // 按分类 + 关键词搜索 GET /products.php?api_key=YOUR_API_KEY&category_id=20101&keyword=笔记本&lang=zh

🧪 在线测试

(已内置)
/products.php?api_key=****&page=1&limit=10
GET /product_detail.php 需认证 公开 详情

📋 功能描述

获取单个商品的完整详细信息,包含完整多语言块、分类信息、规格参数等。

🔗 请求方式

GET /product_detail.php

📌 请求参数

参数名类型必填默认值说明
api_keystring是无API Key(测试时已内置)
idint是无商品ID

📥 请求示例

GET /product_detail.php?api_key=YOUR_API_KEY&id=1

🧪 在线测试

(已内置)
/product_detail.php?api_key=****&id=1
🌍 支持的语言 多语言 共 51 种语言

📋 语言代码列表

以下为系统支持的所有语言代码,可在 lang 参数中使用。

zh 中文 (简体)
zh-TW 中文 (繁体) TW
ja 日本語
ko 한국어
vi Tiếng Việt
th ภาษาไทย
id Bahasa Indonesia
ms Bahasa Melayu
hi हिन्दी
ta தமிழ்
ur اردو
ar العربية
he עברית
fa فارسی
en English (US)
en-GB English (UK) GB
fr Français
de Deutsch
es Español
pt Português
pt-BR Português (BR) BR
it Italiano
nl Nederlands
pl Polski
uk Українська
ru Русский
sv Svenska
da Dansk
no Norsk
fi Suomi
el Ελληνικά
tr Türkçe
ro Română
cs Čeština
hu Magyar
sk Slovenčina
bg Български
hr Hrvatski
sr Српски
lt Lietuvių
lv Latviešu
et Eesti
es-MX Español (MX) MX
fr-CA Français (CA) CA
en-CA English (CA) CA
ar-SA العربية (SA) SA
ar-AE العربية (AE) AE
fil Filipino
km ភាសាខ្មែរ
lo ລາວ
my မြန်မာစာ
📂 现有分类 可挂商品

📋 分类列表(扁平结构)

以下为现有的分类,前端可用于构建下拉选择器或导航菜单。
叶子节点 表示该分类下可直接挂载商品。

11美妆护肤1 件目录/11
19服装与配饰24 件目录/19
❌ 错误码
错误码说明处理建议
0成功-
401未授权检查 API Key 是否正确或是否已启用
400参数错误检查请求参数是否正确
404商品不存在检查商品ID是否正确
500服务器错误联系技术支持