广告改价
专用改价接口,支持固定价和浮动价。最终浮动价格由服务端按实时参考价计算。
HTTP请求
-
POST
/api/v3/fiat/merchant/ads/price -
说明: 请求体使用 JSON 格式。本接口是 POST 请求参数使用 URL query string 规则的例外。
接口权限要求: P2P 广告主
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| advNo | string | 是 | 广告的唯一标识 |
| priceType | integer | 否 | 定价类型:0 = 固定价(默认),1 = 浮动价。不传则按固定价处理。 |
| price | BigDecimal | 条件必填 | 固定价广告的目标单价。priceType 不传或为 0 时必传且必须大于 0;priceType = 1 时不参与浮动价计算。 |
| priceRatio | BigDecimal | 条件必填 | 浮动价广告的目标浮动比例。仅 priceType = 1 时必传且必须大于等于 0;固定价时不参与计算。最终价格由服务端按实时参考价乘以该比例,并按法币精度向下取整。 |
请求示例(固定价,
priceType默认为 0)
{
"advNo": "a1375750128856004608",
"price": 234
}
请求示例(浮动价)
{
"advNo": "a1375750128856004608",
"priceType": 1,
"priceRatio": 0.05
}
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 0 表示成功 |
| msg | string | 结果描述 |
| data | null | 无返回数据 |
响应
{
"code": 0,
"msg": "success",
"data": null
}