跳到主要内容

广告改价

专用改价接口,支持固定价和浮动价。最终浮动价格由服务端按实时参考价计算。

HTTP请求

  • POST /api/v3/fiat/merchant/ads/price

  • 说明: 请求体使用 JSON 格式。本接口是 POST 请求参数使用 URL query string 规则的例外。

接口权限要求: P2P 广告主

请求参数

参数名类型必填描述
advNostring是广告的唯一标识
priceTypeinteger否定价类型:0 = 固定价(默认),1 = 浮动价。不传则按固定价处理。
priceBigDecimal条件必填固定价广告的目标单价。priceType 不传或为 0 时必传且必须大于 0;priceType = 1 时不参与浮动价计算。
priceRatioBigDecimal条件必填浮动价广告的目标浮动比例。仅 priceType = 1 时必传且必须大于等于 0;固定价时不参与计算。最终价格由服务端按实时参考价乘以该比例,并按法币精度向下取整。

请求示例(固定价,priceType 默认为 0)

{
"advNo": "a1375750128856004608",
"price": 234
}

请求示例(浮动价)

{
"advNo": "a1375750128856004608",
"priceType": 1,
"priceRatio": 0.05
}

返回参数

参数类型说明
codeinteger0 表示成功
msgstring结果描述
datanull无返回数据

响应

{
"code": 0,
"msg": "success",
"data": null
}