API of EMPP

### EMPP API 相关知识点概述 #### 一、概览 上海移动通讯开发的短信服务平台，即“企信通”，为企业用户提供了一种便捷、高效的短信服务方式。该平台不仅支持传统的网页操作模式，还提供了多种接口（如HTTP、EMPP等），便于企业通过程序化的方式实现短信的自动化管理和发送。本文将详细介绍该平台提供的EMPP协议相关知识点，并对文档中的FAQ进行深入解读。 #### 二、EMPP协议简介 **EMPP协议**（Enterprise Messaging Protocol Protocol）是一种专门设计用于企业级短信发送的通信协议。它允许企业在自己的系统中集成短信服务功能，从而实现短信的批量发送、状态查询等功能。 #### 三、基本概念解析 1. **MT (Message Termination)**：指由SP（Service Provider，服务提供商）向终端用户发送的短信。 2. **客户短信提交**：客户通过某种方式（如Web界面、API等）向SP提交短信的过程。 3. **提交方式**：包括但不限于Web界面提交、HTTP POST请求提交、EMPP协议提交等。 4. **提交成功**：表示短信已由SP接收并准备发送到目标手机号码。 5. **短信长度限制**：通常单条短信的最大长度为70个汉字或者160个英文字符。 6. **短信拆分**：当短信长度超过单条短信的最大长度时，需要将其拆分成多条短信发送。 7. **黑白名单策略**：用于控制哪些手机号码可以接收短信。黑名单内的号码无法接收短信，而白名单内的号码则可以正常接收短信。 8. **手机状态报告**：指发送短信后，对于目标手机是否成功接收短信的反馈信息。 9. **企信通平台**支持向不同运营商（如移动、联通、电信）的手机以及小灵通发送短信。 #### 四、共性问题解答 1. **短信发送后手机未收到**：可能的原因包括但不限于目标手机号码不在白名单内、目标手机处于欠费停机状态等。 2. **联通手机收不到短信**：需检查是否将联通号码加入白名单，并确认联通手机状态正常。 3. **发送过快/错误代码10004**：表明发送请求过于频繁，需适当调整发送间隔时间。 4. **手机重复收到相同消息**：可能是由于网络延迟导致多次发送请求到达服务器，应设置合理的重试机制。 5. **群发控制错误/错误代码15**：意味着当前用户的群发权限受限，需联系服务商解决。 6. **短信显示乱码**：通常是因为编码问题，确保使用正确的字符集进行编码。 7. **短信发送延时**：可能与网络状况、服务器处理能力有关，也可能是由于短信队列较长造成的。 8. **错误代码10005**：通常表示账号或密码验证失败，请检查账号密码是否正确。 #### 五、基于EMPP协议的短信发送 1. **群发短信状态报告的msgId递增**：为了唯一标识每条短信的状态报告，每次发送群发短信时，msgId需要递增。 2. **状态报告msgid的处理**：需记录每次发送短信时的msgid，以便后续匹配状态报告。 3. **EMPP发送短信内容丢失**：这可能是由于内容长度超过了最大限制或存在特殊字符所致。 4. **EMPP短信拆分**：当短信内容超过70个汉字或160个英文字符时，需要将其拆分为多条短信发送。 5. **EMPP短信提交超长失败**：短信长度超过规定限制时，提交将失败，需进行适当的拆分。 6. **EMPP短信乱码问题**：通常是编码问题导致，需确保使用正确的编码格式。 7. **业务代码填写**：需按照服务提供商的要求填写，通常用于标识发送方的身份。 8. **源号码填写**：用于指定发送短信的号码，需遵循一定的格式。 #### 六、短信回复与状态报告接收 1. **MO (Message Origination)**：指由终端用户向SP发起的短信。 2. **短信状态报告**：包含短信发送状态信息的反馈报告。 3. **HTTP-PUSH方式**：SP主动推送短信状态报告和回复信息到企业的服务器。 4. **HTTP轮询**：企业定时向SP服务器查询短信状态报告和回复信息。 5. **离线消息**：当目标用户离线时，SP会暂时保存短信并等待重新发送的机会。 #### 七、其他相关知识点 - **查询短信发送记录**：通过特定的查询接口，可以获取历史短信发送记录。 - **WEB管理**：包括管理员账号管理、通讯录管理等内容，便于企业进行日常操作。 - **套餐与子账号数目关系**：不同的服务套餐决定了可创建的子账号数量及联系方式的数量。 - **常见问题解答**：涵盖了登录问题、通讯录导入问题等多个方面。 通过以上内容的详细解析，我们可以看到上海移动企信通平台不仅提供了丰富的功能，还通过详细的文档和FAQ帮助用户更好地理解和使用其提供的各项服务。对于希望通过程序化方式高效管理短信服务的企业而言，掌握EMPP协议的相关知识点至关重要。