要接入虾皮(Shopee)电商平台的API接口并根据商品ID获取商品详情,你需要遵循以下步骤:
- 注册与认证:
公共参数
请求地址: 获取请求接入key和secret
- 首先,你需要在Shopee开放平台注册一个账号,并创建一个应用。
- 在创建应用的过程中,你需要填写相关信息,如应用名称、应用描述、回调URL等。
- 完成应用创建后,Shopee会为你生成一个API密钥(API Key)和API密钥秘密(API Secret),这两个密钥将用于后续的API调用身份验证。
|
请求参数:num_iid=264070136/5637247041&country=.com.my
参数说明:num_iid:商品ID-country:网站后缀(.com.my;.vn;.ph)
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| num_iid | Bigint | 0 | 5637247041 | 宝贝ID |
| title | String | 0 | Fashionable plus size womens dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit | 宝贝标题 |
| price | Float | 0 | 22.17 | 价格 |
| orginal_price | String | 0 | 31.68 | 原价 |
| num | Int | 0 | 3836 | 库存 |
| detail_url | String | 0 | shopee.com.my/product/264… | 宝贝链接 |
| pic_url | String | 0 | cf.shopee.com.my/file/f8bc11… | 宝贝图片 |
| brand | String | 0 | No Brand | 品牌名称 |
| favcount | Int | 0 | 2027 | |
| desc | String | 0 | ||
| skus | Mix | 0 | {"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "0:0", "properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】", "quantity": "305", "sku_id": "3166598625985"}] | 商品规格信息列表 |
| has_discount | String | 0 | true | |
| item_size | String | 0 | ||
| cid | Int | 0 | 16 | |
| currency | String | 0 | MYR | |
| size_chart | String | 0 | cf.shopee.com.my/file/6105b7… | |
| sales | Int | 0 | 138 | 销量 |
| item_imgs | Mix | 0 | [{ "url": "cf.shopee.com.my/file/f8bc11…"} | 商品图片 |
| discount | String | 0 | 30% | |
| location | String | 0 | Mainland China | 发货地 |
| shop_id | Int | 0 | 151372205 | 店铺ID |
| seller_info | Mix | 0 | {"nick": "qzq1274334183.my", "city": "Mainland China", "level": 12, "seller_promotion_refresh_time": "2021-01-19 02:00:00", "zhuy": "shopee.com.my/shop/264070…", "shop_type": "A"} | 卖家信息 |
| prop_imgs | Mix | 0 | [] | 属性图片 |
| props_list | Mix | 0 | {20509:9974422: 尺码:36} | 商品属性 |
| props_name | String | 0 | 0:0:T-shirt+skirt:M 建议【42.5-50KG】;0:1:T-shirt+skirt:L 建议 【50-57.5kg】; | 商品属性名 |
| props | Mix | 0 | [{ "name": "产地","value": "中国" }] | 商品详情 |
| current_lang | String | 0 | en | |
| currency_code | String | 0 | MYR | |
| props_img | Mix | 0 | 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg | 属性图片 |
| shop_item | Mix | 0 | [] | |
| relate_items | Mix | 0 | [] | |
| tmall | Boolean | 0 | false | 是否天猫 |
| error | String | 0 | 错误信息 | |
| warning | String | 0 | price_json error;skus miss; | 警告信息 |
| url_log | Mix | 0 | [] | |
| method | String | 0 | item_tmall:pget_item | |
| promo_type | String | 0 |
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
- Golang
- javascript
- JS-SDK
- Ruby
- Swift
- Objective-C
- C
- C++
- Node.JS
- Kotlin
- Rust
- R
- MATLAB
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my"
{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "taobao",
"request_id": "15ee0ffc041242"}
-
阅读API文档:
- 访问Shopee开放平台的API文档,找到与商品详情相关的API接口。
- 仔细阅读API文档,了解接口的基本信息、请求参数、响应格式以及错误处理等。
-
编写代码调用API:
- 根据API文档,使用你熟悉的编程语言(如Python、Java、PHP等)编写代码。
- 在代码中,你需要设置请求头,包括你的API密钥和API密钥秘密。
- 构造请求URL,并传入商品ID作为参数。
- 发送HTTP请求到Shopee的API服务器,并获取响应。