天猫获取商品详情 API 接口设计示例

天猫获取商品详情 API 接口设计示例​

一、接口概述​

该接口用于获取天猫平台上指定商品的详细信息，包括商品基础信息、价格、库存、描述、图片等。​

二、接口地址​

​API地址：o0b.cn/Odin

三、请求方法​

POST​

四、请求参数​

​

| 参数名​          | 类型​     | 是否必选​ | 描述​          |
| ------------- | ------- | ----- | ------------ |
| product_id​   | string​ | 是​    | 天猫商品唯一 ID​   |
| access_token​ | string​ | 是​    | 用于身份验证的访问令牌​ |

​

五、请求示例​

​

TypeScript

取消自动换行复制

{​

"product_id": "1234567890",​

"access_token": "your_access_token_here"​

}​

​

六、响应参数​

​

| 参数名​          | 类型​     | 描述​                    |
| ------------- | ------- | ---------------------- |
| product_name​ | string​ | 商品名称​                  |
| price​        | float​  | 商品价格​                  |
| stock​        | int​    | 商品库存​                  |
| description​  | string​ | 商品描述​                  |
| images​       | array​  | 商品图片 URL 数组​           |
| brand​        | string​ | 商品品牌​                  |
| category​     | string​ | 商品所属类目​                |
| status​       | int​    | 接口状态码，200 表示成功，其他表示失败​ |
| message​      | string​ | 状态描述信息​                |

​

七、响应示例​

​

TypeScript

取消自动换行复制

{​

"product_name": "示例商品名称",​

"price": 99.99,​

"stock": 100,​

"description": "这是一个示例商品的详细描述",​

"images": 

"brand": "示例品牌",​

"category": "示例类目",​

"status": 200,​

"message": "成功获取商品详情"​

}​