数据接口说明

该接口由P2P平台开发,供希财网调用。通过该接口将标的基础数据和投资标的数据返回给希财网,由希财网进行计算。

完成统计接口开发后,请在“接口设置”页面提交接口地址,在接口中需增加参数:type=NewInterface,区分新老接口。


请求参数


参数名 类型 说明
base_time 字符 获取的数据的参考时间,格式:yyyy-mm-dd,例如,如2015-12-12。默认为当天。
t 整数 时间戳(1970-1-1 00:00:00到现在的总秒数)
token 字符 token=md5(md5(t)+client_secret),其中t值为上面的时间戳,client_secret为希财网分配给P2P平台网站对应的client_secret,贵方可以通过t和token(小写)两个参数的值来判断请求的合法性,md5为32位小写。

请求方式

Get


返回数据格式

    {"Data":
        [
            {
                "project_id": "123",
                "title": "测试投标项目1",
                "amount": 100000.0,
                "invest_amount": 100000.0,
                "invest_rate": 1.8,
                "life_cycle": 6,
                "life_cycleunit": "月",
                "borrow_type": "抵押标",
                "pay_type": 4,
                "product_state":1,
                "username": "123456",
                "successtime": "2015-01-01",
                "publishtime": "2015-01-01",
                "ProductSubscribeList": 
                [
                  {
                    "subscribeusername": "12345",
                    "amount": 50000.0,
                    "validamount": 50000.0,
                    "adddate": "2015-01-01",
                    "regdate": "2015-01-01",
                    "repaymentdate":"2015-01-01",
                    "status": 1,
                    "type": 0
                  },
                  {
                    "subscribeusername": "12345789",
                    "amount": 50000.0,
                    "validamount": 50000.0,
                    "adddate": "2015-01-01",
                    "regdate": "2015-01-01",
                    "repaymentdate":"2015-01-01",
                    "status": 1,
                    "type": 0
                  },
                ......
                ]
            },
            ......
        ]
    }

    

返回格式说明

标的信息
字段名 是否必须 字段说明
project_id 项目主键(必须唯一)
product_name 借款标题
amount 借款金额
invest_amount 已投资金额
invest_rate 利率。例如:12,不是年利率的转换为年利率再传,去掉百分比,只传数字
life_cycle 借款期限
life_cycleunit 期限单位:月
reward 奖励。如无奖励则返回0。返回百分比,例如,奖励50元,借款金额为1000元,则奖励为5%,返回5即可。如果是年化奖励,则直接加入利率
borrow_type 借款类型。抵押标、质押标、信用标、流转标、净值标、秒标等等,不限于上述,平台可以自定义,如果是多个,用;,\等分隔符分开
pay_type 还款方式。 1:到期还本息(到期还本付息,一次性还本付息);2:每月等额本息(按月分期,按月等额本息);3:每季分期(按季分期,按季等额本息);4:每月付息,到期还本;5:等额本金(按月等额本金);6:每季付息,到期还本;7:每月付息,分期还本;8:先付息,到期还本
product_state 产品募集状态。-1:流标;0:筹款中;1:已满标;2:已开始还款;3:预发布;4:还款完成;5:逾期
province 借款人所在省份
city 借款人所在城市
username 借款人ID。如果平台出于保护隐私而不愿意提供真实ID,则可以将ID进行哈希处理,只要能一一对应即可,但不能屏蔽其中的一些字符,会造成重复
useratavaterurl 借款人头像地址
amountuseddess 借款用途
revenue 营收,即该笔借款平台收取的服务费,管理费
link_website 标的详细页地址
successtime 满标时间,指最后一位投资人的投资时间。如果没有,则传1970-01-01
publishtime 发标时间

单个标的投标列表信息
字段名 是否必须 字段说明
subscribeusername 投资人ID。如果平台出于保护隐私而不愿意提供真实ID,则可以将ID进行哈希处理,只要能一一对应即可,但不能屏蔽其中的一些字符,会造成重复
amount 投标金额。只计投标金额,不计平台奖励或返还的金额
validamount 有效金额,即实际中标金额
adddate 投标时间(yyyy-mm-dd)
regdate 注册时间(yyyy-mm-dd)
repaymentdate 还款日期(yyyy-mm-dd)
status 投标状态。1:通过;2:部分通过
type 手动或自动投标。0:手动;2:自动

 

注:所有必填项不能为null或者空;如该标的暂无投资记录,则【ProductSubscribeList】节点无需添加,切不可传入空值至该节点。

希财网 版权所有 © 2014-2017  湘ICP备10026015号