说明文档
<h1>凯旋资信查询对接文档</h1>
<h2>1. 概述</h2>
<p>本文档主要描述凯旋资信查询的对接方式，旨在帮助合作机构的开发人员快速开发自己的业务系统以便对接文档中所描述的接口。通过本接口，用户可以获取相关资信信息，从而更有效地进行决策和评估。</p>
<h3>1.1 对接流程</h3>
<ol>
<li>上传查询征信的必要文件信息。</li>
<li>发送查询征信请求。</li>
<li>获取征信数据（执行模型后的数据）。</li>
</ol>
<h2>2. 接口信息</h2>
<h3>2.1 基本信息</h3>
<table>
<thead>
<tr>
<th>接口名称</th>
<th>资信接口</th>
</tr>
</thead>
<tbody>
<tr>
<td>接口版本</td>
<td>v1.0</td>
</tr>
<tr>
<td>接口协议</td>
<td>HTTP</td>
</tr>
<tr>
<td>返回格式</td>
<td>JSON</td>
</tr>
</tbody>
</table>
<h3>2.2 接口地址</h3>
<p><strong>注意：测试环境、生产环境 均需要添加ip白名单 才能正常请求。</strong></p>
<p>测试环境</p>
<pre><code>http://43.138.7.209/cdqsc/</code></pre>
<p>生成环境</p>
<pre><code>对接成功后 准备上线在咨询业务同学 寻求正式环境地址</code></pre>
<h2>3. 请求说明</h2>
<h3>3.1 请求方式</h3>
<ul>
<li><strong>HTTP Method</strong>: POST</li>
</ul>
<h3>3.2 请求参数</h3>
<ul>
<li><strong>公共请求体示例</strong>:</li>
</ul>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必填</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>orgCode</td>
<td>String</td>
<td>是</td>
<td>机构代码（凯旋提供）</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名值 （加解密工具类生成）</td>
</tr>
<tr>
<td>key</td>
<td>String</td>
<td>是</td>
<td>加密后的秘钥 （加解密工具类生成）</td>
</tr>
<tr>
<td>content</td>
<td>String</td>
<td>是</td>
<td>content参数（接口参数加密后的密文）</td>
</tr>
<tr>
<td>timestamp</td>
<td>String</td>
<td>是</td>
<td>时间戳 （加解密工具类生成）</td>
</tr>
</tbody>
</table>
<p>接口中的参数说明定义的入参为 content 加密前的数据，请求时需要将定义好的入参组装成 json 格式的数据并按照加密流程加密后进行传输<br />
<strong>加密后的样例</strong> </p>
<pre><code class="language-json">{
&quot;orgCode&quot;: &quot;maguo&quot;,
&quot;sign&quot;: &quot;3a1060a67c4899408d768d1934479608&quot;,
&quot;key&quot;: &quot;dPnN0VVqP5z2SY/TDUAu82b7tX4Axq7rKtT6HyYBg2Ko902KMvGWEVMFnWXxQCeZBm0V5bcx/PidXcv+aXuo6YSJLZBAdRjVCCBR/3XXLlfq57zlSs2CzeUPAkfl3Vd9hW5qbtY3iv+dICqJ/DHFujYqIGy2hQOhiQYiXYCXuTnoBBNOlfDHawYmKCyauQyTVpJBkPD6RCA+7edEJncXSDgp0Ce3SeV+AtGe7J4nRDEYykvlqmgrveurqoiHsRxk7YBeVoPIzBng+9Hw+eCP7FjmXMPZdbrAQcCJscz1fMS1DgV1MObYGx+uo8pPrFOBGt1bAXo7M7TJcc70A1ZslQ==&quot;,
&quot;content&quot;: &quot;bA68f//ZcRQSAO4s0lGvdrr2K8oy2LKb2mioOwQFDzf7+ZL8l3utVq2gX8EAgF9qhfs6XGHMy9XYcFmkyIwoCw==&quot;,
&quot;timestamp&quot;: &quot;1742438857552&quot;
}</code></pre>
<h2>4. 返回说明</h2>
<h3>4.1 成功响应示例</h3>
<pre><code class="language-json">{
&quot;code&quot;: &quot;0000&quot;,
&quot;msg&quot;: &quot;成功&quot;,
&quot;data&quot;: {
&quot;具体数据&quot;: &quot;具体数据&quot;,
}
}</code></pre>
<h3>4.2 失败响应示例</h3>
<pre><code class="language-json">{
&quot;code&quot;: &quot;9999&quot;,
&quot;msg&quot;: &quot;失败&quot;,
&quot;data&quot;: null
}</code></pre>
<table>
<thead>
<tr>
<th>字段名</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>String</td>
<td>响应状态码 (0000/9999)</td>
</tr>
<tr>
<td>msg</td>
<td>String</td>
<td>信息描述</td>
</tr>
<tr>
<td>data</td>
<td>Object</td>
<td>成功时返回的数据信息</td>
</tr>
</tbody>
</table>
<h2>5. 错误码说明</h2>
<ul>
<li>具体接口有描述</li>
</ul>
<table>
<thead>
<tr>
<th>code</th>
<th>msg</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0001</td>
<td>业务错误</td>
<td>业务错误</td>
</tr>
<tr>
<td>0002</td>
<td>业务错误</td>
<td>对应业务具体描述</td>
</tr>
<tr>
<td>0003</td>
<td>业务错误</td>
<td>对应业务具体描述</td>
</tr>
<tr>
<td>000.....</td>
<td>业务错误</td>
<td>对应接口会有具体描述</td>
</tr>
<tr>
<td>9999</td>
<td>系统异常</td>
<td>系统异常</td>
</tr>
</tbody>
</table>
<h2>6. 注意事项</h2>
<ol>
<li>接口参数传输得加密</li>
<li>请求参数需严格符合格式要求</li>
</ol>
<h2>7. 联系方式</h2>
<p>如有疑问，请联系技术支持：</p>
<ul>
<li><strong>邮箱</strong>: wuxiaolin@kaixuandb.com</li>
<li><strong>电话</strong>: 131-2954-5100</li>
</ul>
<hr />
<p>希望以上内容能够帮助您顺利对接 凯旋资信查询接口。如需进一步的帮助，请随时联系我！</p>