POST Create Tariff Template endpoint.

Endpoint

POST/web/v1/system/tariffs/templates/create WEB

Authentication

• Chain: WEB
• JWT Token: true
• API Key: false
• Permissions: ["tariff:write"]

Rate Limit

Standard rate limit applies.

Headers

Frontend Headers

Header	Required	Description
X-LOCALE	Yes	用户的 locale
Accept-Language	No	语言偏好

Cloudflare Headers

Header	Required	Description
CF-Connecting-IP	Yes	Client IP from Cloudflare
CF-IPCountry	Yes	Client country code
CF-Ray	Yes	Cloudflare Ray ID
CF-Visitor	Yes	Visitor scheme
CF-Worker	No	Cloudflare Worker indicator
CF-TCP-Port	No	Client TCP port
CF-Edge-Keep-Alive	No	Edge keep-alive status
CF-Cache-Status	No	Cache status
CDN-Loop	No	CDN loop detection
X-Real-IP	Yes	Real client IP

Nginx Headers

Header	Required	Description
X-PORTAL-ACCESS-CODE	Yes	Portal access code
X-Real-IP	Yes	客户端真实 IP
X-Forwarded-For	Yes	代理链
X-Forwarded-Proto	Yes	协议

Request Parameters

Body (JSON)

Field	Type	Required	Description
templateCode	String	Yes	模板编码 (必填, 最长 64 字符)
templateName	String	Yes	模板名称 (必填, 最长 128 字符)
description	String	No	描述 (可选, 最长 512 字符)
tariffModel	String	Yes	费率模型 (必填, 如 FIXED, PERCENTAGE, TIERED)
fixedAmount	BigDecimal	Yes	固定金额 (可选)
rate	BigDecimal	Yes	费率比例 (可选)
floorAmount	BigDecimal	Yes	费用下限 (可选)
ceilingAmount	BigDecimal	Yes	费用上限 (可选)
amountScale	Short	No	金额精度 (默认 2)
roundingMode	String	No	舍入模式 (默认 HALF_UP)
bandsConfig	String	No	分段配置 JSON (可选)
isDefault	Boolean	Yes	是否默认模板 (必填)

Response

200 OK

Field	Type	Description
data.bizId	String	业务 ID
data.templateCode	String	模板编码
data.templateName	String	模板名称
data.description	String	描述
data.tariffModel	String	费率模型
data.fixedAmount	BigDecimal	固定金额
data.rate	BigDecimal	费率比例
data.floorAmount	BigDecimal	费用下限
data.ceilingAmount	BigDecimal	费用上限
data.amountScale	Short	金额精度
data.roundingMode	String	舍入模式
data.bandsConfig	String	分段配置 JSON
data.isDefault	Boolean	是否默认模板
data.enabled	Boolean	是否启用
data.createdAt	Instant	创建时间
data.updatedAt	Instant	更新时间

Phase 3 Simulation