全景档案 - 天远API

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | Access-Id | string | 是 | 账号的 Access-Id | 对于业务请求参数 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`，以此方式进行传参。 ```json { "data": "xxxx(base64)" } ``` 对接响应得到的公共参数 ```json { "code": "int", "message": "string", "transaction_id": "string", // 流水号 "data": "string" } ``` **data** 字段为加密的数据，需要解密后查看。 ## 加密和解密机制 账户获得的密钥（**Access Key**）是一个 16 进制字符串，使用 AES-128 加密算法。 ### 加密过程： - 加密模式：**AES-CBC 模式**。 - 密钥长度：**128 位（16 字节）**。 - 填充方式：**PKCS7 填充**。 - **IV（初始化向量）**：IV 长度为 16 字节（128 位），每次加密时随机生成。 - 加密后，将 **IV** 和密文拼接在一起进行传输。 - 最后，将拼接了 IV 的密文通过 **Base64 编码**，方便在网络或文件中传输。 ### 解密过程： - 解密时，首先从 Base64 解码后的数据中提取前 16 字节作为 **IV**。 - 然后使用提取的 **IV**，通过 AES-CBC 模式解密剩余部分的密文。 - 解密后去除 **PKCS7 填充**，即可得到原始明文。

## 请求参数 ```json { "id_card": "string", "name": "string" , "mobile_no": "string", "authorized": "string", } ``` | 名称 | 类型 | 是否必填 | 说明 | |------------|--------|----------|--------------------------| | id_card| String | 是 | 身份证号 | | name | String | 是 | 姓名 | | mobile_no| String | 是 | 手机号 | | authorized| String | 是 | 是否取得用户授权（0:否，1:是） | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 公共字段说明 | 字段名 | 类型 | 说明 | |----------|----------|----------------------| | code | String | 返回状态码 | | message | String | 响应状态码说明 | | data | Object | 响应的主体数据 | | success | Boolean | 请求是否成功 | ### data参数说明 | 参数 | 必选 | 类型 | 描述 | 说明 | |-----------------------|------|--------|--------------------------------------|----------------------------------------------------------------------| | member_count | 否 | string | 逾期机构数 | 近6个月内，发生过逾期行为的机构数量 | | order_count | 否 | string | 逾期订单数 | 最近6个月内，发生过逾期行为的订单总笔数 | | debt_amount | 否 | string | 逾期总金额 | 最近6个月内，发生过逾期行为的每笔订单的逾期金额累加；单位:元 | | debt_detail | 否 | list | 详情见下方 | 0/1/2/3/4/... | | current_org_count | 否 | string | 近1月共债机构数 | 最近一个月发生过共债行为的机构数 | | current_order_count | 否 | string | 近1月共债订单数 | 最近一个月发生过共债行为的订单数 | | current_order_amt | 否 | string | 近1月共债订单已还款金额 | 最近一个月共债订单的已还款总金额 | | current_order_lend_amt| 否 | string | 近1月共债订单金额 | 最近一个月共债订单总金额 | | totaldebt_detail | 否 | list | 历史共债 | 详情见下方 | #### debt_detail 参数 | 参数 | 必选 | 类型 | 描述 | 说明 | |------------|------|--------|--------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | endDay | 否 | string | 逾期时间 | 具体一笔逾期订单的逾期时间，按照`YYYY-MM`形式输出 | | billType | 否 | string | 逾期账期数 | 具体一笔逾期订单的逾期时长，按【账期类型（S/M）+账龄(0/1/…)】形式输出：<br>- S 代表7/14/21天等超短期现金贷账期<br>- M代表30/30+天等多期借贷账期<br>（例：账期30天→M0对应0-30天，M1对应31-60天；账期7天→S0对应0-7天，S1对应8-14天）<br>*S/M的具体周期根据实际平台和产品而定* | | endMoney | 否 | string | 逾期金额 | 具体一笔逾期订单的逾期金额；单位:元 | | endFlag | 否 | string | 是否结清 | 具体一笔逾期订单的最终状态是否结清，`Y`表示已结清，`N`表示未结清 | #### totaldebt_detail 参数 | 参数 | 必选 | 类型 | 描述 | 说明 | |-----------------------------|------|--------|--------------------------------------|----------------------------------------------------------------------| | totaldebt_date | 否 | string | 共债统计时间范围 | 分析该自然月内的共债情况，只支持当前自然月前的6个自然月，格式:`YYYY-MM` | | totaldebt_org_count | 否 | string | 共债机构数 | 用户在统计周期内的共债机构数 | | totaldebt_order_count | 否 | string | 共债订单数 | 用户在统计周期内的共债订单数 | | totaldebt_order_amt | 否 | string | 共债订单已还款金额 | 用户在统计周期内的共债订单已还款金额 | | new_or_old | 否 | string | 疑似借新还旧 | 用户在统计周期内是否发生疑似借新还旧的行为 | | totaldebt_order_lend_amt | 否 | string | 共债订单金额 | 用户在统计周期内的共债订单总金额 | ### 金额区间描述 | 金额区间 | |-------------------------| | (0,1000] | | (1000,2000] | | (2000,3000] | | (3000,4000] | | (4000,6000] | | (6000,8000] | | (8000,10000] | | (10000,20000] | | (20000,40000] | | (40000,60000] | | (60000,80000] | | (80000,100000] | | (100000,150000] | | (150000,200000] | | (200000,250000] | | (250000,300000] | | (300000,350000] | | (350000,400000] | | (400000,450000] | | (450000,500000] | | (500000,550000] | | (550000,600000] | | (600000,650000] | | (650000,700000] | | (700000,750000] | | (750000,800000] | | (80000,850000] | | (850000,900000] | | (900000,950000] | | (950000,1000000] | | >1000000 |