### SP接口开发调测指引详解
#### 一、电信方提供的相关参数说明
在进行SP接口开发之前，首先需要了解电信方所提供的基本参数及其用途，这些参数对于后续的开发及测试至关重要。
- **网关的IP地址**：125.88.122.40。这是SP连接到电信短信网关的唯一地址。
- **网关绑定的端口**：8891。此端口用于SP与电信网关之间的通信。
- **SP接入码**：1062*****（例如106200000）。该接入码是SP的身份标识之一，在短信发送时会被用作发送者的号码显示。
- **SP的登录账号**：201*******（指SPID）。这是SP在电信系统中的唯一标识，用于认证身份。
- **SP的登录密码**：******。由业务管理平台上的SP人员设置或修改。在割接过程中，该密码由电信方分配给各SP。
此外，需要注意的是，**连接SMGW的方式通常采用长连接**，这样可以保持通信链路的连续性，提高效率。同时，为了适应特定用户群体的割接需求（如133、153用户），**整个联调测试将使用现网的189号码进行**。
#### 二、C网接入网关操作（包）填写说明
##### 2.1 Login操作
- **Login包必选参数**：必须全部填写。这些参数包括ClientID、AuthenticatorClient等，用于SP向电信网关进行身份验证。
- **ClientID**：登录账户，填写SPID。
- **AuthenticatorClient**：填写登录密码。
- 示例：
- ClientID=”20100000”；（填写SP的实际SPID）
- AuthenticatorClient=”123456”；（填写SP的实际连接密码）
- **LoginMode**：登录模式，固定值为2。
- **TimeStamp**：当前时间戳。
- **ClientVersion**：客户端版本，值为3。
- **登录结果**：通过Login_Resp的Status字段获取，其中0表示登录成功。
##### 2.2 Deliver操作
- **Deliver包必选参数**：必须全部填写，用于处理来自用户的上行短信。
- **可选参数**：LINKID、SubmitMsgType、SPDealResult等。
- **MsgID**：消息ID。
- **IsReport**：是否需要状态报告。
- **MsgFormat**：消息格式。
- **RecvTime**：接收时间。
- **SrcTermID**：发送方终端ID。
- **DestTermID**：接收方终端ID。
- **MsgLength**：消息长度。
- **MsgContent**：消息内容。
- **LinkID**：连接ID。
- **SubmitMsgType**：提交消息类型。
- **SPDealResult**：SP处理结果。
- **解析例子**：
- MsgID=”02006101121533309981”；
- IsReport=”0”；
- MsgFormat=”15”；
- RecvTime=”2009-1-1215:36:38”；
- SrcTermID=”18900000000”；
- DestTermID=”106200000”；
- MsgLength=”2”；
- MsgContent=”zf”；
- LinkID=“01121538508345583467”；
- SubmitMsgType=”0”；
- SPDealResult=”0”。
- **收到用户上行信息后**，Deliver包中MsgID为接收的值，Status=0即表示处理成功。
##### 2.3 Submit操作
- **Submit包必选参数**：必须全部填写，用于发送下行短信。
- **可选参数**：LINKID、MSGSRC、MServiceID、SubmitMsgType、SPDealResult等。
- **MsgType**：消息类型。
- **NeedReport**：是否需要状态报告。
- **Priority**：优先级。
- **ServiceID**：服务ID。
- **Feetype**：费用类型。
- **FeeCode**：费用代码。
- **FixedFee**：固定费用。
- **MsgFormat**：消息格式。
- **ValidTime**：有效时间。
- **AtTime**：指定发送时间。
- **SrcTermID**：发送方终端ID。
- **ChargeTermId**：计费终端ID。
- **DestTermIDCount**：目标终端数量。
- **DestTermID**：目标终端ID。
- **MsgLength**：消息长度。
- **MsgContent**：消息内容。
- **LinkID**：连接ID。
- **MsgSrc**：消息源。
- **MServiceID**：服务代码。
- **SubmitMsgType**：提交消息类型。
- **SPDealResult**：SP处理结果。
- **点播的填写例子**：
- MsgType=”6”；
- NeedReport=”1”；
- Priority=”3”；
- ServiceID=”120101003010000000285”；
- Feetype=”00”；
- FeeCode=”100”；
- FixedFee=”0”；
- MsgFormat=”15”；
- ValidTime=””；
- AtTime=””；
- SrcTermID=”106200000”；
- ChargeTermId=”18900000000”；
- DestTermIDCount=”1”；
- DestTermID=”18900000000”；
- MsgLength=”6”；
- MsgContent=”点播下行测试”；
- LinkID=”01121538508345583467”；
- MsgSrc=”20100000”；
- MServiceID=”120101003010000000285”；
- SubmitMsgType=”0”；
- SPDealResult=”0”。
- 对于**免费下发和包月用户下发**，需要根据实际情况调整是否需要状态报告、优先级、收费类型和费率等参数。
#### 三、SP连接测试说明
完成接口开发后，接下来进行的是连接测试。这部分主要涉及网络测试、连接测试以及具体的功能测试。
- **网络测试**：确保SP与电信短信网关之间能够正常通信。
- **连接测试**：测试SP与电信短信网关的连接稳定性。
- **第一步测试（短信上下行测试）**：验证上下行短信能否正确发送和接收。
- **第二步测试（业务拨测）**：模拟真实业务场景下的测试，确保各项功能和服务能够正常运行。
以上步骤确保了SP接口的顺利开发和调试，为后续业务割接做好准备。在整个过程中，SP需要严格按照电信方的要求完成各项开发和测试任务，确保业务顺利过渡至新的网络环境。
