短信验证码

接口标识: smsverificationcode 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

短信验证码接口向指定手机号发送验证码或通知类短信，支持国际及港澳台号码，带国际区号即可发送。内容按短信签名加模板发出，只需传入模板变量的实际值，签名与模板不指定时使用默认配置。每次发送返回状态码、结果描述与发送回执ID，是否送达成功一目了然。适合注册验证、登录二次校验与通知触达等场景。

详细介绍

![短信验证码接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_smsverificationcode__1794169113_3a84449e9862.png)

## 接口概述

短信验证码发送接口面向注册验证、登录二次校验、密码找回与通知触达等场景：传入接收手机号与模板变量，平台对接阿里云短信通道完成发送，同步返回发送状态与回执标识。sign_name、template_code 不传时自动回落到默认签名与模板，业务侧无需硬编码，明确返回 OK 才判定发送成功，失败时给出非 0 错误码与原因描述。

## 核心能力

1. **验证码发送**：向指定手机号发送模板短信，验证码等变量经 template_param 以 JSON 传入。

2. **默认签名回落**：sign_name / template_code 不传时自动使用默认签名与模板。

3. **号码格式宽容**：号码支持带 + 国际区号前缀，主体为 6~15 位数字；实际可达范围以短信服务商为准。

4. **发送结果明确**：以服务商返回 OK 为唯一成功标准，失败返回非 0 错误码与原因。

5. **回执可追溯**：返回发送回执 ID（bizid）与请求 ID（request_id），便于对账与问题排查。

## 产品优势

- **接入简单**：POST 请求、JSON 返回，最少传 `phone` 与 `template_param` 两个参数即可发送。

- **结构固定**：成功响应始终返回 code、message、bizid、request_id 四个字段，程序无需猜结构。

- **判定严格**：只有服务商明确返回 OK 才算成功，不会出现「假成功」。

- **降本增效**：验证码、通知类短信统一走接口，省去各业务线重复对接短信通道。

## 效果展示

一句话理解：它就像替你拨号的短信前台——你把号码和要填进模板的内容交给它，它用你报备好的签名和模板把短信发出去，并带回一张发送回执。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |

|------|-----------|------|

| phone | 13800138000 | 接收短信的手机号，必填；支持带 + 国际区号的号码格式 |

| sign_name | 网程科技 | 选填，短信签名；不传则使用默认签名 |

| template_code | SMS_15305**** | 选填，短信模板 Code；不传则使用默认模板 |

| template_param | {"code":"8246"} | 必填，模板变量 JSON 字符串，键名须与模板占位符一一对应 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |

|---------|-----------|---------|

| 发送状态码 | `"OK"` | `code`，发送成功时固定为 OK |

| 状态描述 | `"OK"` | `message`，服务商返回的状态描述 |

| 发送回执 ID | `"9006197469364984400^0"` | `bizid`，这条短信的回执标识，便于对账排查 |

| 请求 ID | `"3C4F0E5A-9B2D-4E8F-A1B6-7D2E5F9C0A12"` | `request_id`，本次请求的唯一标识 |

API请求示例：

```

POST /api/v1/smsverificationcode

phone=13800138000&sign_name=网程科技&template_code=SMS_15305****&template_param={"code":"8246"}

```

API响应示例：

```json

{

"code": 0,

"desc": "成功",

"data": {

"code": "OK",

"message": "OK",

"bizid": "9006197469364984400^0",

"request_id": "3C4F0E5A-9B2D-4E8F-A1B6-7D2E5F9C0A12"

}

```

发送成功时 `code` 固定为 `"OK"`，`bizid` 是这条短信的回执标识；若参数校验不通过或服务商拒绝发送，会收到非 0 错误码与原因描述。

## 应用场景

- **注册验证**：新用户注册时下发验证码，确认手机号真实可用

- **登录保护**：异地登录、敏感操作前的二次校验

- **密码找回**：重置密码链路中的身份确认

- **通知触达**：订单状态、预约提醒等模板化短信通知

- **安全风控**：异常操作触发短信确认，降低账号盗用风险

## 应用案例

- **SaaS 服务商**：多套产品共用统一的签名与模板，各业务线调用时只传手机号与模板变量，短信模板管理收口到一处。

- **在线教育平台**：登录验证与课程提醒统一走本接口，按错误码区分「签名未配置」与「服务商拒绝」，运维排查有明确指向。

- **本地生活应用**：注册验证码与订单通知共用一个发送入口，回执 ID 落库后与投诉工单关联，短信纠纷可快速定位到具体的发送记录。

常见问题

Q：phone 支持什么格式？

A：号码支持带 + 国际区号前缀，主体为 6~15 位数字；国内手机号直接传 11 位号码。格式不合法返回参数错误提示；实际可达范围以你的阿里云短信签名与模板报备情况为准。

Q：template_param 怎么填？

A：传 JSON 字符串，键名与短信模板中的变量占位符一一对应。如模板为「您的验证码是${code}」，则传 {"code":"8246"}。template_param 为必填项，缺失或非法 JSON 会返回参数错误。

Q：sign_name / template_code 不传会怎样？

A：自动回落到默认签名与模板；若入参与默认配置均为空，接口返回错误提示「短信签名未配置」或「短信模板 Code 未配置」。

Q：怎么判断发送成功？

A：响应 code=0 且 data.code 为 "OK" 表示服务商已受理发送，data.bizid 为该条短信的回执标识。受理成功不等于终端已收到，实际送达以运营商与终端状态为准。

短信验证码验证码发送短信通知阿里云短信登录验证短信接口

接口地址： https://www.phpwc.cn/api/smsverificationcode

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`phone`	string	必填	-	接收短信的手机号码，国际/港澳台消息：国际区号 + 号码
`sign_name`	string	选填	-	短信签名名称，如：网程科技
`template_code`	string	选填	-	短信模板 Code，如：SMS_15305****
`template_param`	string	必填	-	短信模板变量对应的实际值，请传入 JSON 字符串。如：{"name":"张三","number":"1390000****"}

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`code`	string	短信发送状态码，示例：OK
`message`	string	短信发送结果描述
`bizid`	string	短信发送回执 ID
`request_id`	string	阿里云请求 ID
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试