# 挂机短信

# 挂机短信



# 挂机短信任务

#### **请求URL**

*   `https://dashboardapi.infin8linx.com/hangupSms/task`

#### **请求方式**

*   POST

#### **请求参数**

| 参数名        | 必选 | 类型     | 说明                                                                             |
| :--------- | :- | :----- | :----------------------------------------------------------------------------- |
| appid      | 是  | string | 鉴权 appid                                                                       |
| accesskey  | 是  | string | 鉴权 accesskey                                                                   |
| name       | 是  | string | 任务名称                                                                    |
| destnumber      | 是  | string | 接收验证码的手机号不需要加国别号码，例如完整号码为：`00628123456789`，则直接以 `8123456789` 请求即可。 |
| voicefile      | 是  | string | 可以在线访问的录音文件地址 |
|answered_sms_tpl     | 可选，但不能与 no_answer_sms_tpl 同时为空  | string | 用户接听使用的短信模板id |
|no_answer_sms_tpl     | 可选，但不能与 answered_sms_tpl 同时为空  | string | 用户未接听使用的短信模板id|
|start_time     | 是  | string |任务开始时间(北京时间)|

#### **请求示例**
```
{
    "appid":"xxxxxx",
    "accesskey":"xxxxx",
    "name":"test1132383",
    "start_time":"2026-10-20 15:53:00",
    "voicefile":"https://xxxx/offlineSound/playback?filename=Tips.mp3",
    "destnumber":"822xxx998",
    "answered_sms_tpl":"",
    "no_answer_sms_tpl":"81"
}
```


#### **返回示例**

```
{
    "code": 0,
    "msg": "operation succeeded",
    "data": {
        "task_id": "4556",
        "count": 1
    }
}
```

#### **返回参数说明**

| 参数名         | 类型     | 说明             |
| :---------- | :----- | :------------- |
| code        | int    | 返回码 0 成功 其他为失败 |
| msg         | string | 返回信息           |
| data        | object | 返回数据           |