删除短信默认验证码手机号配置

编号  :  004

请求参数

返回值

{
    "status": 200,
    "msg": "删除短信默认验证码手机号配置成功",
    "data": []
}

备注

删除短信默认验证码手机号配置。

编辑短信默认验证码手机号配置

编号  :  003

请求参数

返回值

{
    "status": 200,
    "msg": "编辑短信默认验证码手机号配置成功",
    "data": []
}

备注

编辑手机号、场景、启用状态和备注。同一 scene + mobile 不能重复。

添加短信默认验证码手机号配置

编号  :  002

请求参数

返回值

{
    "status": 200,
    "msg": "添加短信默认验证码手机号配置成功",
    "data": {
        "id": 1
    }
}

备注

同一 scene + mobile 不能重复。

阿里云短信发送记录查询

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取阿里云短信发送记录成功",
    "data": {
        "total": 1, // 本次返回总数；传send_status时为筛选后的数量
        "aliyun_total": 1, // 阿里云返回的原始总数
        "per_page": 10, // 每页条数
        "current_page": 1, // 当前页
        "last_page": 1, // 最后一页
        "code": "OK", // 阿里云返回Code
        "message": "OK", // 阿里云返回Message
        "request_id": "7F4C0000-0000-0000-0000-000000000000", // 阿里云请求ID
        "mobile": "17001980145", // 查询手机号
        "send_date": "20260703", // 查询日期，格式YYYYMMDD
        "biz_id": "", // 查询发送流水号
        "send_status": "2", // 查询发送状态
        "data": [
            {
                "phone_num": "17001980145", // 手机号
                "send_status": 2, // 发送状态：1=等待回执，2=发送失败，3=发送成功
                "send_status_name": "发送失败", // 发送状态名称
                "err_code": "MOBILE_NOT_ON_SERVICE", // 运营商回执错误码
                "err_code_message": "停机、空号、暂停服务、关机、不在服务区", // 失败原因文字
                "template_code": "SMS_000000000", // 短信模板CODE
                "content": "验证码：111111", // 短信内容
                "send_date": "2026-07-03 10:00:00", // 发送时间
                "receive_date": "2026-07-03 10:00:00", // 回执时间
                "out_id": "" // 外部流水扩展字段
            }
        ]
    }
}

备注

查询搜索条件：mobile=手机号，必填，只能查询单个手机号；send_date=发送日期，选填，格式YYYY-MM-DD，不传默认今天；biz_id=发送流水号，选填，阿里云发送短信返回的BizId；send_status=发送状态，选填，1等待回执、2发送失败、3发送成功；page=页码，默认1；pageSize=每页显示数，默认10，最大50。返回字段说明：total=本次返回总数，传send_status时为筛选后的数量；aliyun_total=阿里云原始总数；per_page=每页条数；current_page=当前页；last_page=最后一页；code=阿里云返回Code；message=阿里云返回Message；request_id=阿里云请求ID；mobile=查询手机号；send_date=查询日期，格式YYYYMMDD；biz_id=查询流水号；send_status=查询发送状态；data=发送记录列表；phone_num=手机号；send_status_name=发送状态名称；err_code=运营商回执错误码；err_code_message=失败原因文字，按阿里云官方国内消息发送状态回执错误码映射，未知错误码原样返回；template_code=短信模板CODE；content=短信内容；send_date=发送时间；receive_date=回执时间；out_id=外部流水扩展字段。接口底层调用阿里云QuerySendDetails，阿里云限制为单个手机号、单天日期查询。MOBILE_NOT_ON_SERVICE按官方文档返回停机、空号、暂停服务、关机、不在服务区。

短信默认验证码手机号配置列表

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取短信默认验证码手机号配置列表成功",
    "data": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "last_page": 1,
        "data": [
            {
                "id": 1,
                "scene": "oa_admin_login",
                "mobile": "15038236015",
                "state": 1,
                "remark": "原OA短信默认验证码手机号",
                "created_at": "2026-07-03 10:00:00",
                "updated_at": "2026-07-03 10:00:00"
            }
        ]
    }
}

备注

系统后台维护默认短信验证码手机号配置。OA后台短信发送接口命中 scene=oa_admin_login 且 state=1 的手机号时，不调用阿里云短信，直接写入验证码 111111。