网站工商网监标西安人才网官网

一、接口定位与申请流程

1. 接口名称与文档

• 实际接口名称：jingdong.ware.comment.get（商品评价查询接口）
• 官方文档：需登录京东开放平台查看，路径为文档中心 > 商品类目属性 > jingdong.ware.comment.get。

2. 申请流程

(1) 注册与认证

• 步骤1：注册京东开放平台账号，完成支付宝实名认证。
• 步骤2：提交企业资质（营业执照、法人身份证）或个人身份信息。

(3) 创建应用与权限申请

• 步骤3：在开发者中心创建应用，填写应用名称、描述、回调域名等信息。
• 步骤4：在API市场中搜索“商品评论”相关接口（如jingdong.ware.comment.get），提交使用申请，说明使用场景（如数据分析、竞品调研）。

(4) 审核与授权

• 步骤5：提交应用审核，通常1-3个工作日完成。
• 步骤6：审核通过后，获取App Key和App Secret，并签订合作协议。

二、接口参数与调用方法

1. 接口基本信息

• 接口名称：jingdong.ware.comment.get
• 请求方式：HTTPS GET/POST
• 返回格式：JSON
• 基础URL：https://api.jd.com/routerjson

2. 必填参数

参数名	类型	必填	说明
method	String	是	接口名称，固定为jingdong.ware.comment.get
app_key	String	是	京东开放平台分配的App Key
timestamp	String	是	当前时间，格式YYYY-MM-DD HH:mm:ss
format	String	是	返回格式，固定为json
v	String	是	API协议版本，固定为2.0
sign_method	String	是	签名方法，固定为md5
skuId	String	是	商品SKU ID（如100012345678）
page	Integer	是	页码，从1开始
pageSize	Integer	是	每页评论数（最大50）
sortType	Integer	否	排序方式（1=按时间降序，2=按评分降序，默认1）

3. 签名生成方法

python

def generate_sign(params, app_secret):

sorted_params = sorted(params.items(), key=lambda x: x[0])

sign_str = app_secret

for k, v in sorted_params:

sign_str += f"{k}{v}"

sign_str += app_secret

return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

4. 示例代码（Python）

python

import requests

import hashlib

import time

class JDAPI:

def __init__(self, app_key, app_secret):

self.app_key = app_key

self.app_secret = app_secret

self.base_url = 'https://api.jd.com/routerjson'

def _generate_sign(self, params):

sorted_params = sorted(params.items(), key=lambda x: x[0])

sign_str = self.app_secret

for k, v in sorted_params:

sign_str += f"{k}{v}"

sign_str += self.app_secret

return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

def get_comments(self, sku_id, page=1, page_size=10):

params = {

'method': 'jingdong.ware.comment.get',

'app_key': self.app_key,

'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),

'format': 'json',

'v': '2.0',

'sign_method': 'md5',

'skuId': sku_id,

'page': page,

'pageSize': page_size,

'sortType': 1 # 按时间降序

}

params['sign'] = self._generate_sign(params)

response = requests.post(self.base_url, data=params, headers={'Content-Type': 'application/x-www-form-urlencoded'})

return response.json()

# 使用示例

if __name__ == '__main__':

app_key = 'your_app_key'

app_secret = 'your_app_secret'

jd_api = JDAPI(app_key, app_secret)

result = jd_api.get_comments('100012345678', page=1, page_size=5)

print(result)

三、返回数据结构与解析

1. 成功响应示例

json

{

"code": 0,

"message": "success",

"data": {

"total": 12500,

"page": 1,

"pageSize": 10,

"comments": [

{

"userId": "user123456",

"userNick": "京东会员_abc123",

"rating": 5,

"content": "手机运行流畅，拍照效果超出预期",

"creationTime": "2025-06-28 14:30:22",

"pictures": [

"https://img10.360buyimg.com/n1/s450x450_jfs/t1/250000/30/12345/123456/66d12345Eabcd1234/1234567890abcdef.jpg"

],

"replies": [

{

"replyUserId": "jd_official",

"replyContent": "感谢您的认可，我们将持续优化服务",

"replyTime": "2025-06-29 10:15:30"

}

]

}

]

}

}

2. 关键字段说明

字段名	类型	说明
content	String	评论内容
rating	Integer	评分（1-5星）
creationTime	String	评论时间
pictures	List	用户上传的图片链接列表
replies	List	官方或用户的回复内容

四、实时关注用户反馈方案

1. 定时任务监控

• 方案：使用cron或APScheduler库设置定时任务，每小时调用一次API获取最新评论。
• 代码示例：

  python

  from apscheduler.schedulers.blocking import BlockingScheduler

  def fetch_latest_comments():

  latest_page = get_total_pages(sku_id) # 获取总页数

  for page in range(1, latest_page + 1):

  comments = jd_api.get_comments(sku_id, page=page)

  save_to_db(comments)

  scheduler = BlockingScheduler()

  scheduler.add_job(fetch_latest_comments, 'interval', hours=1)

  scheduler.start()

2. 增量数据获取

• 方法：记录上次获取的最大评论时间戳，仅获取该时间之后的新评论。
• 实现逻辑：
  1. 首次全量获取并记录最新评论时间。
  2. 后续调用时，通过creationTime参数筛选新增评论。

3. 数据可视化与报警

• 工具：使用Matplotlib生成评论趋势图，或集成企业微信/钉钉机器人发送异常评论报警。
• 示例代码：

  python

  import matplotlib.pyplot as plt

  def plot_comment_trend(comments):

  times = [comment['creationTime'] for comment in comments]

  plt.plot(times, [comment['rating'] for comment in comments])

  plt.savefig('comment_trend.png')

五、注意事项与合规说明

1. 频率限制：
   • 普通开发者：每分钟不超过200次请求。
   • 企业开发者：可申请提升配额，需联系平台。
2. 数据合规性：
   • 遵守《京东开放平台开发者协议》，禁止将数据用于非法用途（如恶意营销、侵犯用户隐私）。
   • 评论内容可能包含HTML标签，需用正则表达式清洗：

     python

     import re

     clean_content = re.sub(r'<[^>]+>', '', comment['content'])

3. 错误处理：
   • 401错误：Token失效，需重新获取access_token。
   • 400错误：参数错误，检查skuId、page等字段。
4. 替代方案：
   • 若官方API无法满足需求（如需要历史全量数据），可通过京东数据智囊服务（需单独商务洽谈）获取。

通过以上步骤，您可高效接入京东商品评论API，实现评论数据的自动化获取与实时监控，助力业务决策与用户体验优化。