# 逸兔進件回調 接入綜述 ## **1 域名** * 測試環境：[http://api-dev-rx.pjpfljcw.com/](http://api-dev-rx.pjpfljcw.com/) * 生產環境：指定獲取 ## **2 接入條件** > **密鑰對** > > * 生成密鑰對: ssh-keygen -m PEM -t rsa -b 4096 -f id_rsa > * 進行PKCS#8編碼：openssl pkcs8 -topk8 -inform PEM -in id_rsa -outform pem -nocrypt -out private_key.pem > * 根據私鑰生成公鑰：openssl rsa -in private_key.pem -pubout -out public_key.pem * 合作機構申請APP_ID * 合作機構上傳公鑰 ### **2.1 請求格式** 統一采用`POST`，業務數據作為`Json Body`，content-type 固定為`application/json` ### **2.2 公共參數** 與業務無明顯關系的統稱為公共參數，包括并不限于簽名、appId、請求時間等，通通置于Request Header中。 | 參數名 | 必傳 | 備注 | | --- | --- | --- | | B-APP-ID | N（請求平臺接口為必傳） | appId（平臺為各機構分配的AppId，對接時提供） | | B-SIGNATURE | Y | 請求簽名 | | B-TIMESTAMP | Y | 時間戳，精確到毫秒 | ### **2.3簽名方式** 所有請求都需要簽名，簽名算法為RSA加解密`(RSA/MD5withRSA)`MD5字符編碼：utf-8簽名方式為 Json序列化請求參數后使用私鑰進行RSA簽名 #### **2.3.1簽名** 1 將業務參數轉碼成 `json` 字符串 然后進行ASCII碼排序 ``` { "type":3, "val":"20220222122218596" } ``` 2 使用自己生成的私鑰 RSA加密`(RSA/MD5withRSA)` 業務參數生成簽名 3 將生成的簽名放置到 `Request Header` `B-SIGNATURE` 中 4 發送請求 ### **2.3.2驗簽** 1 將業務參數轉碼成 `json` 字符串 然后進行ASCII碼排序 ``` { "type":3, "val":"20220222122218596" } ``` 2 獲取到請求頭中的簽名 3 使用公鑰 和簽名 進行RSA轉碼 ### 請求響應 除明確說明外請求和返回的數據均為utf8編碼，返回數據使用JSON格式，如： ~~~ { "code": 200, "msg": "", "data": { } } ~~~ 其中 code標示請求狀態，200為操作成功，data 為具體的返回數據。其他狀態碼標示操作錯誤，msg會返回具體的錯誤信息 ### 其他說明 * 金額，統一單位元，保留兩位小數 * 時間，統一13位時間戳，精確到毫秒 # API ## 1 審核狀態 #### 請求Path POST`/api-public/loan-half/check-status` #### 請求參數 | 參數名 | 參數名稱 | 參數類型 | 是否允許為空 | 備注 | | --- | --- | --- | --- | --- | | `code` | 審核狀態 | int | 否 | 200: 成功 400:失敗| | `msg` | 原因描述 | string | 否 | 審核失敗時務必給出 失敗原因，成功時為‘審核成功’ | | `type` | 類型 | string | 否 | 1，2 ，3 更多請看 "val字段"| | `val` | 類型 | string | 否 | type=1 val值為手機號，type=2值為身份證號 ，type = 3值為進件時的訂單號 | | `url` | app下載地址 | string | 是 | 審核成功時給出app下載的URL 失敗時可為空字符串 ‘’| | `amount` | 授信金額 | int | 是 | 審核成功時設置放款金額，默認為0 | #### 2.4 響應參數 | 參數名 | 參數名稱 | 參數類型 | 是否允許為空 | 備注 | | --- | --- | --- | --- | --- | | 無 | | | | | ###### 示例 * 成功 ~~~ { "code": 200, "msg":"success"， "data":{} } ~~~ ## 2 放款狀態 #### 請求Path POST`/api-public/loan-half/amount-status` #### 請求參數 | 參數名 | 參數名稱 | 參數類型 | 是否允許為空 | 備注 | | --- | --- | --- | --- | --- | | `loan_status` | 放款狀態 | int32 | 否 | 200: 成功 400:失敗| | `loan_result` | 原因描述 | string | 否 | 放款失敗時務必給出 失敗原因，成功時為‘放款成功’ | | `type` | 類型 | int | 否 | 1，2 ，3 更多請看 "val字段"| | `val` | 類型 | string | 否 | type=1 val值為手機號，type=2值為身份證號 ，type = 3值為進件時的訂單號 | | `url` | app下載地址 | string | 是 | 審核成功時給出app下載的URL 失敗時可為空字符串 ‘’| | `amount` | 放款金額 | int | 是 | 審核成功時設置放款金額，默認為0 | #### 2.4 響應參數 | 參數名 | 參數名稱 | 參數類型 | 是否允許為空 | 備注 | | --- | --- | --- | --- | --- | | 無 | | | | | ###### 示例 * 成功 ~~~ { "code": 200, "msg":"success"， "data":{} } ~~~