创建/更新广告
用于发布新广告或更新已有广告
HTTP请求
- POST
/api/v3/fiat/merchant/ads/save_or_update
接口权限要求: P2P 广告主
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| advNo | string | 否 | 广告的唯一标识（更新时必填） |
| payTimeLimit | integer | 是 | 支付时间限制（分钟） |
| initQuantity | BigDecimal | 是 | 初始可交易的数量 |
| supplyQuantity | BigDecimal | 否 | 用于更新广告，需要增加的广告数量 |
| price | BigDecimal | 是 | 币种的价格 |
| coinId | string | 是 | 交易的币种 ID（如 BTC, ETH 等） |
| countryCode | string | 否 | 国家代码 |
| side | string | 是 | 交易方向：BUY / SELL |
| advStatus | string | 否 | 更新时，如果传入则同时更新广告状态，值见枚举 |
| fiatUnit | string | 是 | 法币类型（如 USD, EUR 等） |
| payMethod | string | 是 | 用户收款账号ID，支持逗号分隔 |
| autoReplyMsg | string | 否 | 自动回复消息 |
| tradeTerms | string | 否 | 交易条款明细 |
| minSingleTransAmount | BigDecimal | 是 | 最小单笔交易金额 |
| maxSingleTransAmount | BigDecimal | 是 | 最大单笔交易金额 |
| kycLevel | string | 否 | 下单方的KYC 认证级别 |
| userAllTradeCountMin | integer | 是 | 交易笔数需大于的最小值 |
| userAllTradeCountMax | integer | 是 | 交易笔数需小于的最大值 |
| maxPayLimit | integer | 否 | 同一个用户在同一个广告最多下多少单 |
| buyerRegDaysLimit | integer | 否 | 买家注册天数限制 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 0 表示成功 |
| msg | string | 结果描述 |
| data | string | 广告编号 advNo |
响应
{
"code": 0,
"msg": "success",
"data": "a1375750128856004608"
}