TRS数家服务系统-开放平台

概述

TRS数家服务系统开放平台提供了微信、微博和新闻等多种数据源的采集、检索、榜单及热点接口,可以满足多领域数据需求。

利用数家API可以轻松实现类似 热点地图热点泡泡图公众号榜单网站健康检查 等功能。

示例:热点地图

示例:热点泡泡图

示例:公众号榜单

示例:网站健康检查

具体方法如下:

#1 注册数家账号

使用TRS数家服务系统-开放平台需要先申请数家账号

点击注册数家账号

注意:已有数家账号请忽略此步骤

#2 申请API

申请开放平台API账号,申请成功后会向数家账号的邮箱中发送APPID和APPKEY。

注意:没有数家账号请返回第一步注册数家账号

  • *数家账号
  • *数家密码
  • *联系
  • *手机号码
  • 单位信息
  •  {{notice}}

#3 下载SDK

下载SDK后根据demo所提供的示例代码进行接口调用。

下载JAVA SDK 下载PHP SDK 下载PYTHON SDK

注意:目前SDK只支持JAVA、PHP和PYTHON版本,更多语言版本敬请期待。

#4 调用API

本API采用积分制,不同的接口调用消耗的积分不同,具体请参见详细API描述,积分不够时请向数家销售或者您的销售经理联系。

调用API时必须使用正确的APPID和APPKEY,根据接口输入相应的参数,服务器会返回json格式的数据。调用接口前请仔细阅读每个API接口的详细说明。

比如,获取"人民日报"、"占豪"、"央视新闻"公众号月榜:

Java源码:

  1. String jsonData;
  2. try {
  3. ApiSdk apiSdk = new ApiSdk(appId, appKey); // 创建一个ApiSdk对象
  4. Map map = new HashMap(); // 参数集合
  5. map.put("weixinid", "rmrbwx\r\nzhanhao668\r\ncctvnewscenter"); // 实际参数
  6. jsonData = apiSdk.send(host + "/weixin/get_rank", map); // 接口调用并获取返回值
  7. System.out.println(jsonData);
  8. } catch (Exception e) {
  9. e.printStackTrace();
  10. }

返回JSON数据:

  1. {
  2. "ir_weixinid": "rmrbwx", // 微信号
  3. "ir_rdcount": 48200482, // 阅读数
  4. "ir_prcount": 2491006, // 点赞数
  5. "dn": 482, // 文章数
  6. "weight": 1230, // 榜单得分
  7. "rank": 1, // 排名
  8. "idx": 1, // 本结果排名
  9. "type": "month", // 榜单类型
  10. "ymd": "20161001_20161031" // 榜单类型日期段
  11. },
  12. {
  13. "ir_weixinid": "zhanhao668",
  14. "ir_rdcount": 20883063,
  15. "ir_prcount": 1275830,
  16. "dn": 239,
  17. "weight": 1195,
  18. "rank": 3,
  19. "idx": 2,
  20. "type": "month",
  21. "ymd": "20161001_20161031"
  22. },
  23. {
  24. "ir_weixinid": "cctvnewscenter",
  25. "ir_rdcount": 39847092,
  26. "ir_prcount": 770111,
  27. "dn": 453,
  28. "weight": 1178,
  29. "rank": 5,
  30. "idx": 3,
  31. "type": "month",
  32. "ymd": "20161001_20161031"
  33. }

是不是觉得很简单,是的话,现在请动手吧。

API列表

更新时间:{{time}}

# 名称 信息 积分
账号API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}
转载API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}
微博API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}
#:其中任务接口调用不消耗积分,只在实际采集时根据采集个数的多少扣除相应积分,每个采集点每次扣除 1 积分,该积分消耗计入每天10000的消耗积分限制。
微信API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}
#:其中任务接口调用不消耗积分,只在实际采集时根据采集个数的多少扣除相应积分,每个采集点每次扣除 5 积分,该积分消耗计入每天10000的消耗积分限制。
新闻API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}
#:其中网康接口调用时不消耗积分,网站检查在网康系统中单独进行限制。
应用API:
{{$index+1}} {{item.path}} {{item.title}} {{item.score}}

错误码说明

更新时间:{{time}}

调用错误JSON示例:

  1. {
  2. "retcode" :10001
  3. "msg" :"参数错误,请参照API文档传递正确的参数",
  4. "path" :"/api/account/get_userinfo"
  5. }

返回代码对照表:

名称 信息
{{item.name}} {{item.note}}

{{APIpath}}

说明:

{{APIshow.title}}

URL:

{{url}}/api/{{APIpath}}

请求方式:

POST

访问授权限制:

访问级别: 普通接口
每调用一次消耗积分: {{APIshow.score}} 积分 (0 为不消耗积分,# 含义见API列表内的描述
为每天消耗积分限制之一:限 {{APIshow.dayscorelimit}} 积分(0 为不限制积分,# 含义见API列表内的描述
为每小时频次限制之一: 限 {{APIshow.hourcountlimit}} 次

请求参数:

# 参数名 必选 类型 说明
{{$index+1}} {{rp.name}} {{rp.select}} {{rp.type}} {{{rp.note}}}

返回JSON示例:

注意:示例均为测试数据,实际数据以接口返回为准

  1. {
  2. "retcode":1,
  3. "retmsg":"接口调用成功",
  4. "path":"/api/xxx/xxx",
  5. "score":xxx,
  6. "hourlimit":xxxx,
  7. "daylimit":xxxxx,
  8. "total":xxx,
  9. "data":[
  10. {{{json}}}
  11. ]
  12. }

返回字段说明:

# 返回字符串 类型 说明
1 retcode int 执行结果代码,详细可参见错误码说明
2 retmsg String 执行结果提示信息
3 path String 接口名
4 score int 剩余积分
5 hourlimit int 每小时还可以访问接口的剩余次数
6 daylimit int 当天还可以消耗的积分数
7 total long 总记录数
8 data List 返回数据集合
{{$index+9}} {{rn.name}} {{rn.type}} {{{rn.note}}}

联系我们

如果您有任何的意见和建议,欢迎随时向我们反馈。我们会尽快联系您,竭诚为您服务!

邮件:datahouse@trs.com.cn
客服QQ:1544757938
服务QQ群:545495830