Loading / 加载中…
Loading / 加载中…
汽车与出行数据
用可选车辆条件搜索广告、读取单条完整广告，并查询品牌、车型与筛选词表。所有输入都以 JSON 形式放在 body 下发送。
正在核对当前可用状态与已批准价格…
JSON 输入，结构化响应。公共网关端点统一使用 POST。
选择品牌筛选前查询品牌标签；此操作未声明 body 字段。
POST /api/v1/polovniautomobili/polovniautomobili-brands使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {}
}查看可用的筛选分组，再选用搜索契约支持的字段。
POST /api/v1/polovniautomobili/polovniautomobili-filter-options使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {}
}使用搜索结果返回的字符串 ad_id（可附带可选 slug）请求单条广告。
POST /api/v1/polovniautomobili/polovniautomobili-listing使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"ad_id": "example",
"slug": "example"
}
}选择品牌枚举中的精确标签，可指定采样 1–10 页以查询车型名称。
POST /api/v1/polovniautomobili/polovniautomobili-models使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"brand": "Alfa Romeo",
"sample_pages": 1
}
}组合可选车辆筛选条件，在 750 页上限内分页查询匹配广告。
POST /api/v1/polovniautomobili/polovniautomobili-search使用 JSON 对象，按文档将参数放入 path、query、headers 和 body，省略未使用的位置。input.headers 是受结构校验的数据，不是浏览器请求头。请勿在此填写凭证。按文档保留 body 的数组、标量或 null；省略与 null 含义不同。
{
"body": {
"air_conditioning": [
"none"
],
"attest": "attested",
"body_type": [
"sedan"
],
"brand": "Alfa Romeo",
"colour": [
"white"
],
"country": "RS",
"country_of_origin": "ME",
"damaged": [
"notDamaged"
],
"doors": "3",
"drive": [
"front"
],
"emission_class": "euro1",
"engine_cc_max": 0,
"engine_cc_min": 0,
"flywheel": "floatingFlywheel",
"fuel": [
"gasoline"
],
"gearbox": [
"manual4Gears"
],
"interior_colour": [
"black"
],
"interior_material": [
"cloth"
],
"listing_age": "all",
"mileage_max": 0,
"mileage_min": 0,
"model": [
"example"
],
"only_with_price": false,
"page": 1,
"page_size": 25,
"plates": [
"domesticPlates"
],
"power_kw_max": 0,
"power_kw_min": 0,
"price_max": 0,
"price_min": 0,
"registered_to_seller": false,
"seats": "2",
"trade_in": [
"noExchange"
],
"wheel_side": "left",
"year_max": 1900,
"year_min": 1900
}
}{ok:true, data, meta:{requestId, chargedCreditUnits, simulated, sourceAttribution}}。data 为该操作的结果，可以为 null；即使 data:null，也按该操作的每次调用价格计费成功。
页码硬上限为 750，page_size 只接受 25、50、100 或 200；更高的页码在请求执行前即被拒绝（INVALID_PARAM，400）。
body.ad_id，即搜索结果返回的数字广告标识（4–12 位数字），以及可选的 body.slug。本站对 ad_id 接受任意字符串；不是 4–12 位数字的标识之后可能失败。