个人出行记录查询
<h3>接口描述</h3>
<ul>
<li>根据身份证号和类型(见type的字段编码)查询个人出行记录</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/person/trip/record/query</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>是否必填</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，见签名算法说明</td>
</tr>
<tr>
<td>idcard</td>
<td>String</td>
<td>是</td>
<td>身份证号码</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>是</td>
<td>类型 <strong>见底部type的字段编号</strong></td>
</tr>
</tbody>
</table>
<h3>签名算法</h3>
<pre><code>sign = sha256(appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 <strong>appId</strong>、服务商分配的 <strong>appSecret</strong>，当前时间毫秒数 <strong>timestamp</strong>，按上述顺序拼接成字符串，再进行 <strong>sha256</strong> 哈希得到。如下：</p>
<pre><code class="language-java">String appId = "xyzxy2121zxyz"；
String timestamp = "1555378976238"；
String appSecret = "efcefcef1121cefcefc1212121"；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>成功返回样例</h3>
<pre><code class="language-json">{
"code": 200, // 成功为200，其它为失败返回码，详见：**code返回码**说明
"msg": "成功", // code对应的说明描述
"taskNo": "97245561403938292676", // 本次请求号
"charge": true, // 计费标志，true 计费，false 不计费
"data": {
"result": "2" //见 **底部type 对应的描述**
}
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
"msg": "身份证号格式错误",
"code": 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见：<strong>code返回码说明</strong></td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志 true - 计费，false - 不计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>结果详细信息，对象，详见成功返回样例</td>
</tr>
</tbody>
</table>
<h3>code返回码说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功 （计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>701</td>
<td>查无数据</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>
<h3>type说明</h3>
<table>
<thead>
<tr>
<th>字段编号</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>S001</td>
<td>乘车人GDC列车购票总次数核验</td>
</tr>
<tr>
<td>S002</td>
<td>用户GDC列车乘车总次数核验 gdcBycarCount</td>
</tr>
<tr>
<td>S003</td>
<td>用户车费消费平均金额核验 consumptionAmountAverage</td>
</tr>
<tr>
<td>S004</td>
<td>用户GDC列车车费消费总金额核验 gdcConsumptionAmountCount</td>
</tr>
<tr>
<td>S005</td>
<td>乘车人近3月乘车总次数核验 threeMonthBycarCount</td>
</tr>
<tr>
<td>S006</td>
<td>乘车人车费消费总金额核验 consumptionTotalAmount</td>
</tr>
<tr>
<td>S007</td>
<td>乘车人手机购票比例核验 phoneBuyTicketPercentage</td>
</tr>
<tr>
<td>S008</td>
<td>乘车人提前0-24小时购票核验 ahead24BuyTicketPercentage</td>
</tr>
<tr>
<td>S009</td>
<td>乘车人购票总次数核验 buyTicketTotalCount</td>
</tr>
<tr>
<td>S010</td>
<td>购票人作为乘车人的退票次数核验 refundTicketCount</td>
</tr>
<tr>
<td>S011</td>
<td>用户关联身份证个数核验 relevanceIdCardCount</td>
</tr>
<tr>
<td>S012</td>
<td>关联手机号个数 relevancePhoneNoCount</td>
</tr>
<tr>
<td>S013</td>
<td>普通列车购票总次数 ptBuyingicketsCount</td>
</tr>
<tr>
<td>S014</td>
<td>乘车总次数 rideCount</td>
</tr>
<tr>
<td>S015</td>
<td>普通列车乘车总次数 ptRideCount</td>
</tr>
<tr>
<td>S016</td>
<td>乘车总里程 totalMileage</td>
</tr>
<tr>
<td>S017</td>
<td>24月内乘车总次数 totalTrips24Count</td>
</tr>
<tr>
<td>S018</td>
<td>总旅行时长 totalTravelTime</td>
</tr>
<tr>
<td>S019</td>
<td>工作日乘车比例 weekDaysTravelProportion</td>
</tr>
<tr>
<td>S020</td>
<td>普通列车车费消费总金额 ptTotalConsumptionAmount</td>
</tr>
<tr>
<td>S021</td>
<td>GDC等级列车乘车比例 gdcRideratio</td>
</tr>
<tr>
<td>S022</td>
<td>高端席别乘车次数（软卧、高软、特等、商务） seniorRideCount</td>
</tr>
<tr>
<td>S023</td>
<td>高端席别乘车比例（软卧、高软、特等、商务） seniorRideRatio</td>
</tr>
<tr>
<td>S024</td>
<td>线下（窗口、自动售票机、电话、代售点）购票比例</td>
</tr>
<tr>
<td>S025</td>
<td>提前N小时购票比例（N=24-48） buyTicketsInadvanceProportion24</td>
</tr>
<tr>
<td>S026</td>
<td>提前N小时购票比例（N=48以上） buyTicketsInadvanceProportion48</td>
</tr>
<tr>
<td>S027</td>
<td>作为购票人的退票数量 retreatTicketCount</td>
</tr>
<tr>
<td>S028</td>
<td>购乘意险数量 buyRidingInsuranceCount</td>
</tr>
<tr>
<td>S029</td>
<td>购乘意险数量占购票张数的比例rateOfBuyRidingInsuranceCountToBuyTicketsCount</td>
</tr>
</tbody>
</table>