商用车配件查询接口
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>https://www.51macc.com/api/Mattrio/CvApi/GetBom</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST
1.只传零件分组“groupId”,此时根据零件分组编码查询分组下配件;
2.只传零件名称“itemName”,此时按照“零件名称”模糊查询,需匹配包括oe、标准名称、原厂名称、别名等,支持查询多个项目,入参按照英文逗号分割;
3.不传零件分组,传OE号“itemId”和零件名称“itemName”,此时优先按照OE精准匹配(需要去掉包含的特殊字符),如OE没有匹配到,再根据零件名称模糊匹配(需匹配标准名称、原厂名称、别名等);
4.groupId和itemName和itemId都不传的话会走常用名称查询
<strong>参数:</strong> </li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">vin</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>vin和carId和publicCode三选一(公告型号)</td>
</tr>
<tr>
<td style="text-align: left;">carId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>vin和carId和publicCode三选一(公告型号)</td>
</tr>
<tr>
<td style="text-align: left;">publicCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>vin和carId和publicCode三选一(公告型号)</td>
</tr>
<tr>
<td style="text-align: left;">groupId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>三级分组第三级id</td>
</tr>
<tr>
<td style="text-align: left;">itemId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>oe号码</td>
</tr>
<tr>
<td style="text-align: left;">itemName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>oe名称</td>
</tr>
<tr>
<td style="text-align: left;">brandId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>品牌</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>页数</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
&quot;msg&quot;: &quot;查询成功&quot;,
&quot;recode&quot;: 0,
&quot;frequency&quot;: 966520,
&quot;checkFrequency&quot;: true,
&quot;bom&quot;: {
&quot;result&quot;: {
&quot;boms&quot;: [
{
&quot;itemId&quot;: &quot;50M16-C43GYC1&quot;,
&quot;itemName&quot;: &quot;驾驶室白车身总成-未喷漆&quot;,
&quot;standardName&quot;: &quot;驾驶室总成&quot;,
&quot;pic_address&quot;: &quot;&quot;,
&quot;Alias&quot;: &quot;车身驾驶室,驾驶室,车壳&quot;,
&quot;factoryPrice&quot;: 0,
&quot;vin&quot;: &quot;&quot;,
&quot;salesPrice&quot;: 0,
&quot;retailprice&quot;: 0,
&quot;qty&quot;: 1,
&quot;groupId&quot;: &quot;&quot;,
&quot;groupName&quot;: &quot;&quot;,
&quot;brandId&quot;: &quot;DF&quot;,
&quot;type&quot;: 0,
&quot;standardNameRussian&quot;: &quot;Кабина в сборе&quot;,
&quot;standardNameEnglish&quot;: &quot;Cab Assembly&quot;
}
],
&quot;totalCount&quot;: 1,
&quot;brandid&quot;: &quot;DF&quot;
},
&quot;pageid&quot;: 1
}
}
</code></pre>
<h3>6) 请求返回结果参数说明:</h3>
<table>
<thead>
<tr>
<th>字段名称</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: right;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>msg</td>
<td style="text-align: center;">信息</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>recode</td>
<td style="text-align: center;">状态码</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>frequency</td>
<td style="text-align: center;">剩余次数</td>
<td style="text-align: center;">int</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>bom</td>
<td style="text-align: center;">返回结果</td>
<td style="text-align: center;">object</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>bom>>pageid</td>
<td style="text-align: center;">当前页数</td>
<td style="text-align: center;">int</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>bom>>result</td>
<td style="text-align: center;">返回结果</td>
<td style="text-align: center;">object</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>result</td>
</tr>
<tr>
<td>result>>totalCount</td>
<td style="text-align: center;">总项目数</td>
<td style="text-align: center;">int</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>result>>brandid</td>
<td style="text-align: center;">品牌</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>result>>boms</td>
<td style="text-align: center;">返回结果</td>
<td style="text-align: center;">array</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms</td>
</tr>
<tr>
<td>boms>>itemId</td>
<td style="text-align: center;">oe号码</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>itemName</td>
<td style="text-align: center;">oe名称</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>standardName</td>
<td style="text-align: center;">标准名称</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>pic_address</td>
<td style="text-align: center;">bom地址</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>Alias</td>
<td style="text-align: center;">别名</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>factoryPrice</td>
<td style="text-align: center;">价格</td>
<td style="text-align: center;">double</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>vin</td>
<td style="text-align: center;">vin码</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>salesPrice</td>
<td style="text-align: center;">价格</td>
<td style="text-align: center;">double</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>retailprice</td>
<td style="text-align: center;">价格</td>
<td style="text-align: center;">double</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>qty</td>
<td style="text-align: center;">用量</td>
<td style="text-align: center;">int</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>groupId</td>
<td style="text-align: center;">三级分组id</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>groupName</td>
<td style="text-align: center;">三级分组名称</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>brandId</td>
<td style="text-align: center;">品牌</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">-</td>
</tr>
<tr>
<td>boms>>type</td>
<td style="text-align: center;">是否有实物图片</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
<td style="text-align: right;">0代表没有1代表有</td>
</tr>
<tr>
<td>boms>>standardNameRussian</td>
<td style="text-align: center;">标准名称俄语翻译名称</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
</tr>
<tr>
<td>boms>>standardNameEnglish</td>
<td style="text-align: center;">标准名称英文翻译名称</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">Y</td>
</tr>
</tbody>
</table>
<h3>7) 状态码说明:</h3>
<table>
<thead>
<tr>
<th>状态码</th>
<th style="text-align: center;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td style="text-align: center;">返回正常</td>
</tr>
<tr>
<td>-1</td>
<td style="text-align: center;">暂无数据</td>
</tr>
<tr>
<td>-2</td>
<td style="text-align: center;">账号或者密码错误</td>
</tr>
<tr>
<td>-3</td>
<td style="text-align: center;">当天次数已用完</td>
</tr>
<tr>
<td>-4</td>
<td style="text-align: center;">请求太频繁了,请一个小时后再试(按天次的有限制)或者账号在异地登录</td>
</tr>
<tr>
<td>-5</td>
<td style="text-align: center;">接口报错</td>
</tr>
<tr>
<td>-11</td>
<td style="text-align: center;">此VIN码不符合校验规则或为非国标码</td>
</tr>
<tr>
<td>-12</td>
<td style="text-align: center;">解析vin失败</td>
</tr>
<tr>
<td>-13</td>
<td style="text-align: center;">暂不支持该品牌查询</td>
</tr>
<tr>
<td>-999</td>
<td style="text-align: center;">账号已被封禁</td>
</tr>
</tbody>
</table>