短信服务调用方可通过消息组+密码+拉取的条数，拉取短信上行

<span id="接口说明"></span>
## 接口说明


* 请求方式：`POST`

* 接口地址：`https://sms.volcpartner.com/generic/mo`

* 注意事项：

   * 当记录被拉取后，会被记录成已获取状态；再次请求此接口时，会继续返回未返回过的数据

   * 已经被拉取过的上行，无法被再次拉取


<span id="请求参数"></span>
## 请求参数

<span id="header"></span>
### **Header**


|**参数** |**数据类型** |**是否必填** |**示例值** |**描述** |
|---|---|---|---|---|
|Content\-Type |string |是 |application/json;charset=utf\-8 |指定请求消息体的结构化格式。短信服务的 Content\-Type 为`application/json;charset=utf-8`。 |


<span id="body"></span>
### Body


|**参数** |**类型** |**是否必填** |**示例值** |**描述** |
|---|---|---|---|---|
|sub_account |string |是 |6df864b1 |消息组ID |
|password |string |是 |\*\*\*\*\*\*\*\* |密码 |
|count |int |是 |200 |拉取条数，最大拉取条数200 |


<span id="返回参数"></span>
## 返回参数

请求响应数据以JSON格式返回，以下仅列出了短信业务逻辑相关的字段，其他公共返回参数详见[返回结果](https://www.volcengine.com/docs/6369/80336)。


|**参数** |**类型** |**说明** |
|---|---|---|
|account |string |火山引擎账号 |
|sub_account |string |消息组ID |
|signature |string |签名 |
|content |string |上行内容 |
|mobile |string |手机号 |
|channel_type |string |短信类型 |
|service_id |string |发送通道，非必传，国际/港澳台短信没有该字段 |
|ext |string |用户透传字段 |
|recv_time |string |收到上行时间 |


<span id="示例"></span>
## 示例

<span id="请求示例"></span>
### 请求示例

```json
{
    "sub_account": "71f67923",
    "password": "1234567",
    "count": 1
}
```


<span id="返回示例"></span>
### 返回示例


* **成功响应示例**


```json
[
    {
        "account":"2100001206", // 火山账号
        "sub_account":"078f8037",//消息组ID
        "signature":"",//短信签名
        "content":"hhhhh", // 上行内容
        "mobile":"", //手机号
        "channel_type":"CN_OTP", // 短信发送类型: 验证码 通知 营销
        "service_id":"106920088418200001",
        "ext":"ext", // 用户透传字段
        "recv_time": 1651760981000 // 收到上行时间
    }
]
```



* **失败响应示例**


```json
{
    "status_code": -1,
    "status_message": "auth failed"
}
```


<span id="错误码"></span>
## 错误码

如果您在返回结果中遇到错误消息，可以使用下表作为详细信息和解决方案的指南。其中火山引擎网关公共错误码请参考[火山引擎网关公共错误码](https://www.volcengine.com/docs/6369/68677)。


|**Code** |**Message** |**说明** |**处理建议** |
|---|---|---|---|
|\-1 |错误描述 | | |