聚信立報告檢視獲取儲存解決方案

weixin_33782386發表於2017-04-06

目前聚信立提供瞭如下介面:

1.獲取access_token介面:
https://www.juxinli.com/api/v2/access_report_token
GET請求,引數:org_name,client_secret,hours

2.根據使用者資訊獲取報告介面:
https://www.juxinli.com/api/access_report_data
GET請求,引數:client_secret,access_token,name,idcard,phone

3.獲取到採集流程的token列表(私有介面):
https://dev.juxinli.com/devPlatformApi/rest/query/reports
GET請求,引數:start,end,pageIndex,pageSize,name
此私有介面為聚信立技術人員私下提供,使用此介面需要在請求頭中把Authorization傳遞過去(即需要登入的授權認證

4.根據採集TOKEN獲取報告:
https://www.juxinli.com/api/access_report_data_by_token
GET請求,引數:client_secret,access_token,token

上述2和4介面可以用來獲取使用者的報告,區別是:

  • 介面2需要傳遞使用者的name、idcard以及phone,分別對應著使用者的姓名、身份證、手機號。如果一個使用者填寫了多次,那就會獲取到多個報告,如下圖:
    1074621-a782078969871ba4.png
    一個使用者可以擁有多份報告
    這個可以看作為便利介面,即可以通過使用者的個人資訊快速獲取到此使用者的所有報告。但聚信立把此介面獲取介面但時限設定為15天,也就是說15天之前的報告無法通過這個介面獲取,而必須使用介面4。
  • 介面4是根據引數token來獲取到某一個特定到報告,採集token可以理解為一份報告到唯一標示id,它與這份報告是一一對應的關係。
    1074621-14be581581229ec6.png
    一個採集token對應一份報告
    這個介面沒有時間限制,只要聚信立的資料裡還存在這份報告,就可以拿著採集token通過這個介面獲取到相應的報告。

另外介面1用來獲取企業的安全憑證碼,這相當於企業使用聚信立介面的通行令。所有其他介面呼叫時必須填寫的引數access_token就是通過它獲取到的。
其中org_name是申請聚信立服務時的組織機構名稱,client_secret是聚信立提供的企業或組織唯一客戶標示碼,hours是標示此access_token的有效期限,1標示1小時內有效,24標示24小時內有效,per標示永久有效。

介面3是一個私有介面,可以使用chorme在聚信立後臺扒到。

1074621-01aced348f30c610.png
chrome除錯工具獲取私有介面

這個介面必須授權登入後才能呼叫,因此在使用PawPostman等http請求除錯工具時必須在請求頭中將Authorization的值手動新增進去(值可以從chrome中取得,如上圖)。
但有一個問題,由於Authorization是有時間限制的(目前發現聚信立24小時後就會發生變化),那就無法在程式碼裡寫死,故無法將這個介面作為常用介面使用,而只能一次性使用將獲取到到採集token列表寫入自己到資料庫。

金保姆後臺目前存在到問題

  • 在稽核階段(初審和終審)檢視的聚信立報告可能因為使用者再次填寫而發生變化,而稽核人員需要隨時看到最新的報告
1074621-86f1515ea39c94dc.png
稽核
  • 已放款模組中需要檢視之前的聚信立報告
1074621-3e1531d59f8deb17.png
已放款
  • 聚信立反饋考慮到巨大的資料量,他們只會為商戶儲存三個月的資料,而我們之前沒有進行儲存

針對上述問題,目前給出的解決方案如下

  • 在稽核階段,包括初審和終審直接呼叫介面2來獲取聚信立報告
    介面2的時效是15天,而稽核一般只需要1-3個工作日,完全可以應付報告檢視的需求。
    接下來就是儲存報告的步驟,分以下幾種情況:
  1. 初審不通過
    直接最新的報告寫入資料庫
  2. 初審通過,終審不通過
    初審通過後不操作,在稽核人員點選終審不通過的按鈕後將報告寫入資料庫
  3. 初審通過,終審通過
    初審通過後不操作,在稽核人員點選終審通過的按鈕後將報告寫入資料庫
  4. 初審通過,終審也通過,但稽核人員點選重稽核(有句mmp不知當講不當講!)
    這種情況,之前但資料庫裡已經存過一份報告,但使用者是否需要重新填寫聚信立無法確認,即無法確認是否會產生新的報告。那隻能再次獲取到最新的報告寫入資料庫。
    綜上所述,在初審不通過按鈕被點選時寫入資料庫,以及終審步驟的兩個按鈕任意一個被點選後都進行寫入資料庫操作
1074621-4f29492f24459492.png
點選初審不通過
1074621-6abc68d8819ff392.png
終審按鈕被點選
  • 之後在已放款中檢視此次借款對應的報告就直接從資料庫獲取而不需要呼叫介面
    需要注意的是,必須使用idcard(身份證)去資料庫去找對應人的報告,如果查出多份報告,以分頁的形式在已放款頁面顯示,具體如下圖
1074621-bcf8eae070ae28be.png
樣式供參考

相關文章