菜单

云号码列表

使用说明

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

请求说明

POST /api/v1/cloudNumber/numberList

请求参数

参数	类型	必需	说明
phone_number	string	否	手机号码
keyword	string	否	关键字
status	array	否	状态筛选，1:正常，2：过期
type_ids	array	否	类型ID
region_ids	array	否	国家ID
renewal_status	array	否	续费状态
remark	string	否	备注
page	int	否	请求页码，若不传则默认为第一页
pagesize	int	否	每页数量，若不传则默认10条/页

请求示例

json 复制代码

{
    "phone_number":"",
    "keyword":"",
    "status":[],
    "type_ids":[],
    "region_ids":[],
    "renewal_status": [],
    "remark": "",
    "page":1,
    "pagesize":10
}

返回示例

json 复制代码

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": "6XdPL", // 号码ID
                "phone_number": "", // 手机号码，为空则表示生成中
                "region_id": "oKCDn", // 国家ID
                "region_name": "美国", // 国家名称
                "type_id": "1KoRd", // 类型ID
                "type_name": "虚拟号码", // 类型名称
                "renewal_status": 0, // 自动续费，0：否，1：是
                "remark": "", // 备注
                "status": 1, // 状态，1：正常，2：过期
                "status_name": "正常", // 状态名称
                "expired_at": "2026-01-30 18:10:49" // 过期时间
            },
            {
                "id": "JvRc8",
                "phone_number": "",
                "region_id": "oKCDn",
                "region_name": "美国",
                "type_id": "1KoRd",
                "type_name": "虚拟号码",
                "renewal_status": 0,
                "remark": "",
                "status": 1,
                "status_name": "正常",
                "expired_at": "2026-01-30 18:10:49"
            }
        ],
        "page": 1,
        "pagesize": 2,
        "total": 10,
        "total_page": 5
    },
    "message": "Success"
}

上一个

云号码

下一个

写入短信

最近修改: 2026-01-09Powered by

大纲