菜单

购买云号码

购买云号码。注意：由于不同地区云号码可购买的时长套餐不同， 为保证购买顺利，购买前请查询云号码套餐时长详情，以获取不同地区云号码所支持的购买时长。

POST /api/v1/cloudNumber/purchase

参数	类型	必需	说明
region	string	是	地区，必须符合 ISO 3166-1 alpha-2 格式。例如：中国 CN；美国 US；俄罗斯 RU；巴西 BR 等等。完整的国家代码列表可通过 ISO 3166 国家代码列表获取
duration	integer	是	购买时长，由于不同地区的云号码可购买的时长套餐不同，请查询云号码套餐时长详情获取购买地区所支持的购买时长
type	integer	否	类型， 0 虚拟号码；1 实体号码。未传时默认为实体号码
quantity	integer	否	购买数量，未传时默认为 1
coupon_code	string	否	优惠码
renewal_status	int	否	是否自动续费，0 否； 1 是，默认为1

json 复制代码

{
    "region": "US",
    "duration": "30",
    "type": 1,
    "quantity": 2,
    "renewal_status": 1,
    "coupon_code": "xxxxxxx"
}

json 复制代码

{
    "code": 200,
    "data": {
        "order_id": "xxxx"  // 订单号
    },
    "message": "Success"
}

上一个

购买套餐时长详情

下一个

续费套餐时长详情

最近修改: 2026-06-10Powered by

大纲