菜单

云号码列表

使用说明

获取云号码列表，支持分页，每页最大100条

请求说明

POST /api/v1/cloudNumber/numberList

请求参数

参数	类型	必需	说明
phone_number	string	否	手机号码
status	array	否	状态，1 正常，2 过期
type_ids	array	否	类型，1 实体号，2 虚拟号
region_ids	array	否	国家筛选，必须符合 ISO 3166-1 alpha-2 格式，例如：中国 CN；美国 US；俄罗斯 RU；巴西 BR 等等。完整的国家代码列表可通过 ISO 3166 国家代码列表获取
renewal_status	array	否	是否自动续费，1 是，0 否
remark	string	否	备注
sort_by	string	否	排序字段，created_at 创建时间；expired_at 过期时间
order	string	否	排序规则，asc 正序；desc 倒序
page	int	否	请求页码，若不传则默认为第一页
pagesize	int	否	每页数量，若不传则默认10条/页

返回参数

参数	类型	说明
id	string	云号码ID
phone_number	string	手机号码，为空则表示生成中
region_name	string	国家
type_name	string	类型
status_name	string	状态
renewal_status	integer	自动续费，0：否，1：是
remark	string	备注
created_at	string	创建时间（GMT+08:00）
expired_at	string	过期时间（GMT+08:00）

请求示例

json 复制代码

{
    "page": 1,
    "pagesize": 10,
    "sort_by": "created_at",
    "order": "asc",
    "phone_number": "xxxxxxxxx",
    "region_ids": ["US","GB"],
    "type_ids": [1,2],
    "status": [2],
    "renewal_status": [1,0],
    "remark": "xxx",
}

返回示例

json 复制代码

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "xxxxx",      // 号码ID
                "phone_number": "", // 手机号码，为空则表示生成中
                "region_name": "美国", // 国家
                "type_name": "虚拟号码", // 类型
                "renewal_status": 0, // 自动续费，0：否，1：是
                "remark": "", // 备注
                "status_name": "正常", // 状态
                "created_at": "2025-12-08 11:05:15",  // 创建时间
                "expired_at": "2026-01-30 18:10:49" // 过期时间
            }
        ],
        "page": 1,
        "pagesize": 10,
        "total": 1,
        "total_page": 1
    },
    "message": "Success"
}

上一个

云号码

下一个

云号码短信查询

最近修改: 2026-03-20Powered by

大纲