管理中心首页

一、合作的要求

关闭 —展开 +

平台提供的数据必须符合以下标准。
(1) 字段格式需要符合下文中的数据字段说明。
(2) 借款标的金额与该标的投标金额总和一致。
(3) 有完整的历史数据。
(4) 能及时更新最新的标,至少在当天24:00能更新当天所有的标,接口于每天12点和24点取数据。
(5) 平台必须申请档案和导航,通过审核之后,数据准确方可在页面显示。

注:
1. 根据网贷之家自律红线,如果平台上连续(三天内)出现三个及以上借款标的综合年化利率超过36%(月息3分以上),网贷之家有权关闭平台数据的显示。
http://bbs.wdzj.com/forum.php?mod=viewthread&tid=89831&highlight=%D7%D4%C2%C9%BA%EC%CF%DF
2. 如果发现平台数据接口出现问题或数据不准,我方会关闭平台数据的显示并与平台沟通。
3. 一旦发现平台数据造假。我方有权立即关闭平台数据的显示并取消当月评级资格。
4. 请开发人员查看本文档,在了解清楚后,再申请接入。

二、数据的作用

关闭 —展开 +

1、 http://shuju.wdzj.com/ 用于展示在这页面的数据。
2、 是参与网贷之家评级的前提条件之一。
3、 计入月报数据统计,平台名称有机会出现在统计数据中。

三、数据接入步骤

关闭 —展开 +

1、使用平台账户登录开放平台。

2、绑定自己的平台。

3、数据对接-基本信息-申请接入。

4、数据接口地址、手机、邮箱、QQ。

5、接口URL地址样本: http://www.xxxx.com/xxx?token=&date=2015-03-17&page=1&pageSize=500。
        要求:只需要输入URL?如:http://****?后面我们会自动拼接。请务必分页,防止数据流失。
        入参:date(满标时间,和返回的满标的successTime一致),page(当前页,currentPage),pageSize(每页的借款标数),token(登陆URL返回的token)

6 、登录URL地址样本(可选开发):http://www.xxxx.com/xxx? username=用户名&password=密码。
        要求:只需要输入URL如:http://****?,?后面我们会自动拼接,拼接字符串要求为小写的username和password。
        入参:username,password(平台自行设定,并填写到接口信息中)
登录返回数据要求:json对象下data对象下token值。
格式如:{"data":{"token":"e40536f43730cc4e3bb7aeeb4e5136be"}},token一小时可重复使用。

7、数据返回结果。

四、标的信息数据字段说明

关闭 —展开 +
*请仔细阅读字段说明并参照第五部分“标的信息返回格式示例”,按字段要求传数据,不符合字段要求则无法展示到网贷之家的数据板块。(特别注意:字段大小写必须符合规范,必须的字段一定要进行传递)

1、返回json串格式

  1. {
  2. “totalPage”:”8”,
  3. “currentPage”:”2”,
  4. “totalCount”:”180”,
  5. “totalAmount”:”5000000”,
  6. “borrowList”:[]//借款标json,格式参考下面第五大点
  7. }
字段名 类型 字段说明 是否必需
totalPage String 总页数(每页显示20条借款标信息)
currentPage String 当前页数(从1开始)
totalCount int 总标数
totalAmount Double 当天借款标总额
borrowList List 借款标信息(参照下面)
2、借款标信息
注意:改数据为borrowList的数组对象。 注意:如果有债权转让标 projectId就是 项目主键_日期 比如 1234_20150101 为发布20150101时间。
字段名 类型 字段说明 是否必需
projectId String 项目主键(唯一)
title String 借款标题
amount double 借款金额(若标未满截标,以投标总额为准)
schedule String 进度
*例如:100(只传满标数据,进度均为100)
interestRate String 利率
* 百分比 例如:24.5%
统一转化为年化利率传过来。
deadline int 借款期限
deadlineUnit String 期限单位
* 仅限 ‘天’ 或 ‘月’
reward double 奖励
* 奖励统一返回比例,而不是奖励金额。例如:奖励50元,借款金额1000元; 奖励=50/1000=5% 即返回’5’)
奖励比例统一去掉’%’,比如奖励比例1.2%则返回’1.2’即可
年化奖励直接加到利率字段中
是(如果平台系统无奖励字段,则统一返回0)
type String 例如: 抵押标 ,质押标,信用标,债权转让标,净值标,秒标等。移动端数据需注明移动端。(对于不参与计算平均利率的秒标(天标)、活动标(体验标),就传“秒标”或是“活动标”)
借款类型可根据平台的情况修改,不限于上述类型。若一个标有多个类型,则在每个类型中间加半角分号“;”(如实地认证+担保,就传“实地认证;担保”)
repaymentType int 还款方式
1:到期还本息(到期还本付息,一次性还本付息,按日计息到期还本,一次性付款、秒还)
2:每月等额本息(按月分期,按月等额本息)
3:每季分期(按季分期,按季等额本息)
5:每月付息到期还本(先息后本)
6:等额本金(按月等额本金)
7:每季付息到期还本(按季付息到期还本)
8:每月付息分期还本
9:先付息到期还本
subscribes List 投资人数据(具体字段看下面的投标列表信息)
province String 借款人所在省份。
*比如“广东”,“浙江”等,去掉“省”
city String 借款人所在城市。
userName String 借款人ID(多借款人使用逗号[,]分割)
*不能将ID加*隐藏部分字符,否则会导致多个借款人使用同一个ID,导致借款集中度高。 如果借款人id包含[,]请替换为其他符号
*如果需要加密,请用借款人手机号MD5加密(32位大写)
userAvatarUrl String 发标人头像的URL
amountUsedDesc String 借款用途
revenue double 营收。
*即该笔借款平台收取的服务费、管理费等。
loanUrl String 标的详细页面地址链接
successTime String 标的成功时间。(满标的时间)
*注意:是标被投满的时间(此标最后一个投标人投标的时间),而不是发标时间。
*格式为标准时间格式:’2014-07-23 12:23:22’
注意:getProjectsByDate调用时必须有该字段。
publishTime String 发标时间
*格式为标准时间格式:’2014-07-23 12:23:22’
plateType String 标所属平台频道板块
如:爱投资频道下的融资租赁、保理等
guarantorsType String 保障担保机构名称
如:爱投资标保障机构
isAgency int 是否机构借款
*0:否,1:是
3、单个标的投标列表信息
字段名 类型 字段意思 是否必需
subscribeUserName String 投标人ID
*不能将ID加*隐藏部分字符,否则会导致多个投资人使用同一个ID,导致投资集中度高。
*如果需要加密,请用投资人手机号MD5加密(32位大写)
amount double 投标金额
* 用户初始投标的金额。对于平台优惠奖励政策的情况(如投标人投****元自动返还**元,或是某个人获得满标奖励**)只计投标金额。
validAmount double 有效金额
* 实际中标金额。
如平台无’投标金额’和’有效金额’之分,则’投标金额’和’有效金额’传一样的即可。
addDate String 投标时间
*格式为标准时间格式:’2014-07-23 12:23:22’
status int 投标状态
*1:全部通过
  2:部分通过
注意:平台没有这个字段的默认为1
type int 标识手动或自动投标
0:手动 1:自动
注意:平台没有这个字段的默认为0
sourceType int 投标来源:
1 :PC端
2 :WAP端
3 :平台APP客户端
4 :微信
****备注:关于非必需字段,平台可以不提供。但如果平台有相关信息还是建议加上,因为我们网站数据页面仍会不断更新,会添加新指标,只有提供了相关信息才能统计(比如平台借款人地域分布,平台借款用途分布等)。

五、标的信息返回格式示例

关闭 —展开 +
  1. {
  2. “totalPage”:”2”,
  3. “currentPage”:”1”,
  4. “borrowList”:[{
  5. “title”:”第18期 东坡区停车场经营权和苗圃全责任质押担保借款”,
  6. “amount”:”80000.00”,
  7. “schedule”:”100.00”,
  8. “interestRate”:”22.00%”,
  9. “deadline”:”6”,
  10. “deadLineUnit”:”月”,
  11. “reward”:”1.2”,
  12. “type”:”信用标”,
  13. “repaymentType”:”1”,
  14. “projectId”:”2270”,
  15. “province”:”湖南”,
  16. “city”:”长沙”,
  17. “userName”:”zyjj”,
  18. “userAvatarUrl”:”http://www.xxxx.com/user/1098/1098.jpg”,
  19. “amountUsedDesc”:”资金周转”,
  20. “revenue”:80,
  21. “loanUrl”:”http://www.xxxx.com/borrow.htm?jid=2270”,
  22. “publishTime”:”2014-08-14 17:00:25”,
  23. “successTime”:”2014-08-15 10:08:34”,
  24. “plateType”:”爱担保产品”,
  25. “guarantorsType”:”XXX融资租赁责任有限公司”,
  26. “subscribes”:[
  27. {”status”:1,”amount”:”45000.00”,”type”:0,”validAmount”:”45000.00”,”addDate”:”2014-08-14 17:19:54”,”subscribeUserName”:”savoury”,”sourceType”:”2”},
  28. {”status”:1,”amount”:”1000.00”,”type”:0,”validAmount”:”1000.00”,”addDate”:”2014-08-14 17:35:05”,”subscribeUserName”:”sew12313”,”sourceType”:”2”},
  29. {”status”:1,”amount”:”10036.04”,”type”:0,”validAmount”:”10036.04”,”addDate”:”2014-08-14 18:24:16”,”subscribeUserName”:”swefdsf”,”sourceType”:”2”},
  30. {”status”:1,”amount”:”1000.00”,”type”:0,”validAmount”:”1000.00”,”addDate”:”2014-08-14 20:03:26”,”subscribeUserName”:”efdv”,”sourceType”:”2”},
  31. {”status”:1,”amount”:”186.10”,”type”:0,”validAmount”:”186.10”,”addDate”:”2014-08-14 22:16:11”,”subscribeUserName”:”小米”,”sourceType”:”3”},
  32. {”status”:1,”amount”:”2960.18”,”type”:0,”validAmount”:”2960.18”,”addDate”:”2014-08-15 00:47:56”,”subscribeUserName”:”ererfd23”,”sourceType”:”3”},
  33. {”status”:1,”amount”:”11265.15”,”type”:0,”validAmount”:”11265.15”,”addDate”:”2014-08-15 10:06:59”,”subscribeUserName”:”ddd203”,”sourceType”:”3”},
  34. {”status”:1,”amount”:”182.48”,”type”:0,”validAmount”:”182.48”,”addDate”:”2014-08-15 09:46:44”,”subscribeUserName”:”gggewr”,”sourceType”:”3”},
  35. {”status”:1,”amount”:”122.25”,”type”:0,”validAmount”:”122.25”,”addDate”:”2014-08-15 10:06:16”,”subscribeUserName”:”erer”,”sourceType”:”3”},
  36. {”status”:1,”amount”:”204.81”,”type”:0,”validAmount”:”204.81”,”addDate”:”2014-08-15 10:07:05”,”subscribeUserName”:”werwr”,”sourceType”:”4”},
  37. {”status”:1,”amount”:”3721.97”,”type”:0,”validAmount”:”3721.97”,”addDate”:”2014-08-15 10:07:09”,”subscribeUserName”:”efxsd”,”sourceType”:”1”},
  38. {”status”:1,”amount”:”5000”,”type”:0,”validAmount”:”4321.02”,”addDate”:”2014-08-15 10:08:34”,”subscribeUserName”:”3rew”,”sourceType”:”2”}
  39. ]
  40. },
  41. {
  42. “title”:”第19期 东坡区停车场经营权和苗圃全责任质押担保借款”,
  43. “amount”:”80000.00”,
  44. “schedule”:”100.00”,
  45. “interestRate”:”20.00%”,
  46. “deadline”:”3”,
  47. “deadLineUnit”:”月”,
  48. “reward”:”0.6”,
  49. “type”:”抵押标”,
  50. “repaymentType”:”2”,
  51. “projectId”:”2271”,
  52. “province”:”湖南”,
  53. “city”:”长沙”,
  54. “userName”:”abcc”,
  55. “userAvatarUrl”:”http://www.xxxx.com/user/1098/1099.jpg”,
  56. “amountUsedDesc”:”资金周转”,
  57. “revenue”:80,
  58. “loanUrl”:”http://www.xxxx.com/borrow.htm?jid=2271”,
  59. “publishTime”:”2014-08-14 17:00:25”,
  60. “successTime”:”2014-08-15 10:08:34”,
  61. “plateType”:”爱担保产品”,
  62. “guarantorsType”:”XXX融资租赁责任有限公司”,
  63. “subscribes”:[
  64. {”status”:1,”amount”:”45000.00”,”type”:0,”validAmount”:”45000.00”,”addDate”:”2014-08-14 17:19:54”,”subscribeUserName”:”savoury”,”sourceType”:”2”},
  65. {”status”:1,”amount”:”1000.00”,”type”:0,”validAmount”:”1000.00”,”addDate”:”2014-08-14 17:35:05”,”subscribeUserName”:”sew12313”,”sourceType”:”2”},
  66. {”status”:1,”amount”:”10036.04”,”type”:0,”validAmount”:”10036.04”,”addDate”:”2014-08-14 18:24:16”,”subscribeUserName”:”swefdsf”,”sourceType”:”2”},
  67. {”status”:1,”amount”:”1000.00”,”type”:0,”validAmount”:”1000.00”,”addDate”:”2014-08-14 20:03:26”,”subscribeUserName”:”efdv”,”sourceType”:”2”},
  68. {”status”:1,”amount”:”186.10”,”type”:0,”validAmount”:”186.10”,”addDate”:”2014-08-14 22:16:11”,”subscribeUserName”:”小米”,”sourceType”:”3”},
  69. {”status”:1,”amount”:”2960.18”,”type”:0,”validAmount”:”2960.18”,”addDate”:”2014-08-15 00:47:56”,”subscribeUserName”:”ererfd23”,”sourceType”:”3”},
  70. {”status”:1,”amount”:”11265.15”,”type”:0,”validAmount”:”11265.15”,”addDate”:”2014-08-15 10:06:59”,”subscribeUserName”:”ddd203”,”sourceType”:”3”},
  71. {”status”:1,”amount”:”182.48”,”type”:0,”validAmount”:”182.48”,”addDate”:”2014-08-15 09:46:44”,”subscribeUserName”:”gggewr”,”sourceType”:”3”},
  72. {”status”:1,”amount”:”122.25”,”type”:0,”validAmount”:”122.25”,”addDate”:”2014-08-15 10:06:16”,”subscribeUserName”:”erer”,”sourceType”:”3”},
  73. {”status”:1,”amount”:”204.81”,”type”:0,”validAmount”:”204.81”,”addDate”:”2014-08-15 10:07:05”,”subscribeUserName”:”werwr”,”sourceType”:”4”},
  74. {”status”:1,”amount”:”3721.97”,”type”:0,”validAmount”:”3721.97”,”addDate”:”2014-08-15 10:07:09”,”subscribeUserName”:”efxsd”,”sourceType”:”1”},
  75. {”status”:1,”amount”:”5000”,”type”:0,”validAmount”:”4321.02”,”addDate”:”2014-08-15 10:08:34”,”subscribeUserName”:”3rew”,”sourceType”:”2”}
  76. ]
  77. }

六、提前还款数据字段说明

关闭 —展开 +
* 此接口为可选接口,但是为了贵司数据准确,建议接入,数据返回格式请参考第七大点

1、返回json串格式

  1. {
  2. “totalPage”:”8”,
  3. “currentPage”:”2”,
  4. “preapys”:[]//提前还款json,格式参考下面第七大点
  5. }
字段名 类型 字段说明 是否必需
totalPage String 总页数(每页显示20条借款标信息)
currentPage String 当前页数(从1开始)
preapys List 提前还款信息(参照下面)
2、提前还款信息
注意:该数据为preapys的数组对象。
字段名 类型 字段说明 是否必需
projectId String 项目主键* 必须和和标的信息项目主键一致.
deadline int 借款期限
deadlineUnit String 期限单位
* 仅限 ‘年’ 或 ‘月’ 或 ‘天’

七、提前还款返回格式示例

关闭 —展开 +
  1. {
  2. ”totalPage”:1,
  3. ”currentPage”:1,
  4. ”preapys”:[
  5. {
  6. ”deadline”:”12”,
  7. ”deadlineUnit”:”月”,
  8. ”projectId”:”0114a9dbe27a5665aaadc8e76cc559de”
  9. },
  10. {
  11. ”deadline”:”1”,
  12. ”deadlineUnit”:”年”,
  13. ”projectId”:”8c12e8ba929a67c28c6f2a8ff7bff470”
  14. }
  15. ]
  16. }