免费获取 API 密钥
短信 API

极速集成的全球通信 API

采用标准 HTTP 协议与 Bearer 令牌鉴权，全局 JSON 载荷。无缝对接各类海内外业务系统，为您提供 99.99% 的高并发可用性承诺。

下载PDF 想看非技术性的概述吗？
Documentation
接入流程

三步发出第一条短信

  1. 01

    注册账号

    免费注册后即可领取测试额度，无需预付。

  2. 02

    获取 API 密钥

    在控制台创建 API 密钥，并按文档配置 Webhook 回调地址。

  3. 03

    调用接口发送

    发送第一条测试短信，通过状态报告确认送达结果。

免费注册，立即发第一条
快速接入

10 分钟，发出第一条短信

标准 HTTP 接口，Bearer 令牌鉴权，JSON 请求与响应。下方示例覆盖 cURL、Node.js、PHP、Python、Java，也可一键导入 Postman / Apifox，填入 API 密钥即可调试。

免费获取密钥，立即调试 查看 API 文档
一键导入调试工具 导入短信 API 到 Postman 或 Apifox，填入 API 密钥即可发送测试短信
导入 Postman 导入 Apifox

下载后在 Postman 或 Apifox 中选择「导入」拖入文件；或在「导入 → URL / 链接」粘贴导入链接（Apifox 可开启定时同步）： https://api.ismsnow.com/downloads/sms-api.openapi.json

send_sms.sh
  1. # 发送短信（type 为 plain 表示文本短信）
  2. curl -X POST https://app.ismsnow.com/api/v3/sms/send \
  3. -H "Authorization: Bearer YOUR_API_KEY" \
  4. -H "Content-Type: application/json" \
  5. -H "Accept: application/json" \
  6. -d '{
  7. "recipient": "8613800000000",
  8. "sender_id": "Signature",
  9. "type": "plain",
  10. "message": "您的注册验证码为：123456，5分钟内有效。本条为通道实测短信，正式接入后，短信签名与正文内容均支持自定义修改。"
  11. }'

sender_id 填 Signature 即可，为占位值，无需修改：测试阶段签名 / 发件人 ID 由平台统一下发，不会按此处填写的内容变更；开通正式发送后，按您报备通过的签名发送。示例中的验证码 123456 可替换为任意 6 位数字。

RESTful HTTP 接口

Bearer 令牌鉴权，JSON 请求与响应，任意语言都能调用

批量与定时发送

多个号码用逗号分隔一次提交，schedule_time 设置定时发送

发送记录查询

按消息 ID 查询单条短信，或查看全部消息的发送记录

额度查询

通过接口随时查看账户剩余的短信额度

鉴权

每个请求都需要在请求头中携带 API 令牌，鉴权方式为 Bearer，并声明接受 JSON 响应。注册后可在控制台获取 API 令牌。

请求头必填说明
Authorization 是 Bearer 鉴权，值为 Bearer {api_token}；api_token 在客户后台「开发者」页生成
Accept 是 设置为 application/json
Content-Type 否 POST / PATCH 带请求体时设置为 application/json

短信 API

短信、彩信、语音都用同一个发送地址，用 type 区分。消息内容含中文等非 GSM 字符时自动按 unicode 发送。如在后台「开发者」页选了 API 发送通道，接口发送都走该通道。

BASE https://app.ismsnow.com/api/v3/sms/send

发送短信

POST https://app.ismsnow.com/api/v3/sms/send

向一个或多个号码发送短信，可定时发送。需要账号具备短信发送权限（短信快速发送、批量发送或营销任务任一项），否则返回 403。

参数

参数 类型 必填 说明
recipient string 是 接收号码，带国际区号、不带 +，如 8613800138000。多个号码用英文逗号分隔
sender_id string 否 测试阶段填 Signature 即可，为占位值，无需修改：签名 / 发件人 ID 由平台统一下发，不会按此处填写的内容变更。开通正式发送后为号码（含区号）或字母发件人 ID（最长 11 位），需是账号已报备的签名 / 发件人
type string 否 plain（默认，短信）或 unicode
message string 是 消息内容。示例中的验证码 123456 可替换为任意 6 位数字。含中文等非 GSM 字符时自动按 unicode 发送
schedule_time datetime 否 定时发送，格式 Y-m-d H:i，如 2026-10-08 09:30，按账号时区

单个号码示例请求

request.sh
  1. curl -X POST https://app.ismsnow.com/api/v3/sms/send \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json' \
  4. -H 'Content-Type: application/json' \
  5. -d '{
  6. "recipient": "8613800000000",
  7. "sender_id": "Signature",
  8. "type": "plain",
  9. "message": "您的注册验证码为：123456，5分钟内有效。本条为通道实测短信，正式接入后，短信签名与正文内容均支持自定义修改。"
  10. }'

多个号码示例请求

request.sh
  1. curl -X POST https://app.ismsnow.com/api/v3/sms/send \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json' \
  4. -H 'Content-Type: application/json' \
  5. -d '{
  6. "recipient": "8613800000000,8613900000000",
  7. "sender_id": "Signature",
  8. "type": "plain",
  9. "message": "您的注册验证码为：123456，5分钟内有效。本条为通道实测短信，正式接入后，短信签名与正文内容均支持自定义修改。",
  10. "schedule_time": "2026-10-08 09:30"
  11. }'

成功响应

response.json
  1. {
  2. "status": "success",
  3. "message": "说明文字",
  4. "data": {
  5. "uid": "606812e63f78b",
  6. "to": "8613800138000",
  7. "from": "YourName",
  8. "message": "您的验证码是 123456",
  9. "status": "Delivered",
  10. "cost": "1"
  11. }
  12. }

失败响应

error.json
  1. {
  2. "status": "error",
  3. "message": "错误原因"
  4. }

查看短信

GET https://app.ismsnow.com/api/v3/sms/{uid}

uid 为发送时返回的消息 uid。只能查询自己账号的消息。

想实时收到状态回执和上行短信，可在「开发者」页配置 Webhook，平台会主动推送，无需轮询。

参数

参数 类型 必填 说明
uid string 是 发送时返回的消息 uid（URL 路径参数），只能查询自己账号的消息

示例请求

request.sh
  1. curl https://app.ismsnow.com/api/v3/sms/606812e63f78b \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json'

成功响应

response.json
  1. {
  2. "status": "success",
  3. "data": {
  4. "uid": "606812e63f78b",
  5. "to": "8613800138000",
  6. "from": "YourName",
  7. "message": "您的验证码是 123456",
  8. "status": "Delivered",
  9. "cost": "1"
  10. }
  11. }

失败响应

error.json
  1. {
  2. "status": "error",
  3. "message": "错误原因"
  4. }

查看所有消息

GET https://app.ismsnow.com/api/v3/sms?page=1

按时间倒序，每页 25 条，用 page 翻页。返回字段：uid、to / from（接收号码 / 发件人）、message、status（发送状态，如 Delivered、Failed）、cost（费用）。

参数

参数 类型 必填 说明
page integer 否 页码，按时间倒序，每页 25 条

示例请求

request.sh
  1. curl https://app.ismsnow.com/api/v3/sms?page=1 \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json'

成功响应

response.json
  1. {
  2. "status": "success",
  3. "data": [
  4. {
  5. "uid": "606812e63f78b",
  6. "to": "8613800138000",
  7. "from": "YourName",
  8. "message": "您的验证码是 123456",
  9. "status": "Delivered",
  10. "cost": "1"
  11. }
  12. ]
  13. }

失败响应

error.json
  1. {
  2. "status": "error",
  3. "message": "错误原因"
  4. }

个人资料 API

查看账号余额与个人资料，无需额外权限。

BASE https://app.ismsnow.com/api/v3/me

查看短信额度

GET https://app.ismsnow.com/api/v3/balance

返回字段：remaining_balance 通用余额（不限量时为「无限」）；wallets 各类余额明细（国内短信、国际短信、彩信等），其中 general 即通用余额；expired_on 套餐到期时间。

示例请求

request.sh
  1. curl https://app.ismsnow.com/api/v3/balance \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json'

成功响应

response.json
  1. {
  2. "status": "success",
  3. "data": {
  4. "remaining_balance": "1000",
  5. "wallets": {
  6. "general": "1000"
  7. },
  8. "expired_on": "2027-10-03"
  9. }
  10. }

失败响应

error.json
  1. {
  2. "status": "error",
  3. "message": "错误原因"
  4. }

查看个人资料

GET https://app.ismsnow.com/api/v3/me

返回账号的基本资料。

示例请求

request.sh
  1. curl https://app.ismsnow.com/api/v3/me \
  2. -H 'Authorization: Bearer {api_token}' \
  3. -H 'Accept: application/json'

成功响应

response.json
  1. {
  2. "status": "success",
  3. "data": {
  4. "uid": "606812e63f78b",
  5. "api_token": "...",
  6. "first_name": "张",
  7. "last_name": "三",
  8. "email": "user@example.com",
  9. "locale": "zh",
  10. "timezone": "Asia/Shanghai",
  11. "last_access_at": "2026-10-03 10:00"
  12. }
  13. }

失败响应

error.json
  1. {
  2. "status": "error",
  3. "message": "错误原因"
  4. }

联系人、联系人分组等更多接口，请登录后台查看完整文档。 登录后台

接口能力

接入短信所需的一切

从第一次测试调用到正式上线，同一套接口覆盖验证码、通知与营销场景。

RESTful API

标准 HTTP 动词与 JSON 请求，任何语言都能直接调用。

HTTP + JSON

额度查询

通过接口查询各类短信余额与套餐到期时间，便于在系统内做额度提醒。

余额 · 到期时间

Webhook 状态报告

每条短信的发送结果主动推送到您的回调地址，推送失败自动重试 3 次。

失败重试 3 次

变量短信

支持自定义签名与点对点变量内容，一次请求发送个性化短信。

自定义签名

全球覆盖

国际短信依据接收号码所在国家和地区计费。

190+ 国家/地区

成功计费

按发送成功的条数计费，失败条数依据通道回执返还。

失败返还

高并发接入

支持高并发 API 调用，满足注册高峰与批量通知。

批量发送

免费测试

注册即可领取测试额度，先调通再充值。

注册即得
FAQ

开发者常见问题

如何获取 API 密钥？

免费注册 iSMSNOW 账号后，在控制台即可创建 API 密钥，注册同时赠送测试额度。

支持哪些接入方式？

提供 RESTful API（HTTP + JSON）与 SMPP 网关两种方式，可按系统现状选择。

如何获取短信的发送结果？

配置 Webhook 回调地址后，平台会主动推送每条短信的状态报告；推送失败时自动重试 3 次，也可随时通过接口查询。

如何计费？

平台统一按发送成功的条数结算，发送失败的条数自动返还。发往中国大陆的国内短信经 106 三网合一通道下发，支持按量计费与套餐两种方式，套餐规模越大单价越低，最低可至 US$0.0057/条；发往海外的国际短信按接收号码所在国家和地区独立计价，各国单价公开可查，充值金额越多单价越低。所有价格以美元（USD）计价，实际单价以控制台显示为准。

发送内容有什么要求？

发送要求取决于您购买的套餐类型。国内短信套餐适用于验证码与通知场景；营销推广请选用国内营销短信套餐，金融、游戏、社交等特殊行业请选用行业专用通道。行业专用通道、独享号码池、彩信与双向短信在开通前，需与商务确认发送内容与使用场景。

无缝对接您的底层业务。
用 iSMSNOW 极其优雅的 API 架构支撑千万级高频触达。

免费注册，10 分钟完成接入