{ "info": { "name": "iSMSNOW 短信 API", "description": "iSMSNOW API（https://www.ismsnow.com）。导入后在集合变量中填写 apiKey（控制台 → API 设置获取），即可发送测试请求。\n鉴权：Authorization: Bearer {apiKey}", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://app.ismsnow.com", "type": "string" }, { "key": "apiKey", "value": "YOUR_API_KEY", "type": "string" } ], "item": [ { "name": "短信 API", "item": [ { "name": "发送短信（单个号码）", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v3/sms/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v3", "sms", "send" ] }, "body": { "mode": "raw", "raw": "{\n \"recipient\": \"8613800000000\",\n \"sender_id\": \"Signature\",\n \"type\": \"plain\",\n \"message\": \"您的注册验证码为：123456，5分钟内有效。本条为通道实测短信，正式接入后，短信签名与正文内容均支持自定义修改。\"\n}", "options": { "raw": { "language": "json" } } }, "description": "向一个或多个号码发送短信，可定时发送。需要账号具备短信发送权限（短信快速发送、批量发送或营销任务任一项），否则返回 403。\n\n参数：\n- recipient（string，必填）：接收号码，带国际区号、不带 +，如 8613800138000。多个号码用英文逗号分隔\n- sender_id（string，可选）：测试阶段填 Signature 即可，为占位值，无需修改：签名 / 发件人 ID 由平台统一下发，不会按此处填写的内容变更。开通正式发送后为号码（含区号）或字母发件人 ID（最长 11 位），需是账号已报备的签名 / 发件人\n- type（string，可选）：plain（默认，短信）或 unicode\n- message（string，必填）：消息内容。示例中的验证码 123456 可替换为任意 6 位数字。含中文等非 GSM 字符时自动按 unicode 发送\n- schedule_time（datetime，可选）：定时发送，格式 Y-m-d H:i，如 2026-10-08 09:30，按账号时区" }, "response": [ { "name": "成功", "code": 200, "status": "OK", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"说明文字\",\n \"data\": {\n \"uid\": \"606812e63f78b\",\n \"to\": \"8613800138000\",\n \"from\": \"YourName\",\n \"message\": \"您的验证码是 123456\",\n \"status\": \"Delivered\",\n \"cost\": \"1\"\n }\n}", "_postman_previewlanguage": "json" }, { "name": "失败", "code": 400, "status": "Bad Request", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"message\": \"错误原因\"\n}", "_postman_previewlanguage": "json" } ] }, { "name": "发送短信（多个号码）", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v3/sms/send", "host": [ "{{baseUrl}}" ], "path": [ "api", "v3", "sms", "send" ] }, "body": { "mode": "raw", "raw": "{\n \"recipient\": \"8613800000000,8613900000000\",\n \"sender_id\": \"Signature\",\n \"type\": \"plain\",\n \"message\": \"您的注册验证码为：123456，5分钟内有效。本条为通道实测短信，正式接入后，短信签名与正文内容均支持自定义修改。\",\n \"schedule_time\": \"2026-10-08 09:30\"\n}", "options": { "raw": { "language": "json" } } }, "description": "向一个或多个号码发送短信，可定时发送。需要账号具备短信发送权限（短信快速发送、批量发送或营销任务任一项），否则返回 403。\n\n参数：\n- recipient（string，必填）：接收号码，带国际区号、不带 +，如 8613800138000。多个号码用英文逗号分隔\n- sender_id（string，可选）：测试阶段填 Signature 即可，为占位值，无需修改：签名 / 发件人 ID 由平台统一下发，不会按此处填写的内容变更。开通正式发送后为号码（含区号）或字母发件人 ID（最长 11 位），需是账号已报备的签名 / 发件人\n- type（string，可选）：plain（默认，短信）或 unicode\n- message（string，必填）：消息内容。示例中的验证码 123456 可替换为任意 6 位数字。含中文等非 GSM 字符时自动按 unicode 发送\n- schedule_time（datetime，可选）：定时发送，格式 Y-m-d H:i，如 2026-10-08 09:30，按账号时区" }, "response": [ { "name": "成功", "code": 200, "status": "OK", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"说明文字\",\n \"data\": {\n \"uid\": \"606812e63f78b\",\n \"to\": \"8613800138000\",\n \"from\": \"YourName\",\n \"message\": \"您的验证码是 123456\",\n \"status\": \"Delivered\",\n \"cost\": \"1\"\n }\n}", "_postman_previewlanguage": "json" }, { "name": "失败", "code": 400, "status": "Bad Request", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"message\": \"错误原因\"\n}", "_postman_previewlanguage": "json" } ] }, { "name": "查看短信", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v3/sms/:uid", "host": [ "{{baseUrl}}" ], "path": [ "api", "v3", "sms", ":uid" ], "variable": [ { "key": "uid", "value": "", "description": "发送时返回的消息 uid（URL 路径参数），只能查询自己账号的消息" } ] }, "description": "uid 为发送时返回的消息 uid。只能查询自己账号的消息。\n\n想实时收到状态回执和上行短信，可在「开发者」页配置 Webhook，平台会主动推送，无需轮询。\n\n参数：\n- uid（string，必填）：发送时返回的消息 uid（URL 路径参数），只能查询自己账号的消息" }, "response": [ { "name": "成功", "code": 200, "status": "OK", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"data\": {\n \"uid\": \"606812e63f78b\",\n \"to\": \"8613800138000\",\n \"from\": \"YourName\",\n \"message\": \"您的验证码是 123456\",\n \"status\": \"Delivered\",\n \"cost\": \"1\"\n }\n}", "_postman_previewlanguage": "json" }, { "name": "失败", "code": 400, "status": "Bad Request", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"message\": \"错误原因\"\n}", "_postman_previewlanguage": "json" } ] }, { "name": "查看所有消息", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v3/sms", "host": [ "{{baseUrl}}" ], "path": [ "api", "v3", "sms" ] }, "description": "按时间倒序，每页 25 条，用 page 翻页。返回字段：uid、to / from（接收号码 / 发件人）、message、status（发送状态，如 Delivered、Failed）、cost（费用）。\n\n参数：\n- page（integer，可选）：页码，按时间倒序，每页 25 条" }, "response": [ { "name": "成功", "code": 200, "status": "OK", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"data\": [\n {\n \"uid\": \"606812e63f78b\",\n \"to\": \"8613800138000\",\n \"from\": \"YourName\",\n \"message\": \"您的验证码是 123456\",\n \"status\": \"Delivered\",\n \"cost\": \"1\"\n }\n ]\n}", "_postman_previewlanguage": "json" }, { "name": "失败", "code": 400, "status": "Bad Request", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"message\": \"错误原因\"\n}", "_postman_previewlanguage": "json" } ] } ] } ] }