Symbian平台飞信客户端接口规范

飞信Symbian客户端接口规范 2006年7月18日 1 1. 范围 18 2. 参考文献 18 3. 术语和缩略语 19 4. 系统结构 20 5. 基础协议 20 5.1. SMS 20 5.2. HTTP 21 5.3. SIP 21 5.4. SDP 21 5.5. XML 21 5.6. 加密算法 21 5.7. 压缩算法 21 6. SIP-C基础 22 6.1. 概述 22 6.2. SIP方法的缩写 22 6.3. SIP消息头的缩写 23 7. 服务状态改变 23 7.1. 业务定购 23 7.1.1. 移动设备 24 7.1.1.1. 过程描述 24 7.1.1.2. 短信发送格式 - [SMS-Register] 24 7.1.1.3. 短信接收格式 - [SMS-RSP-Register] 25 7.1.2. 非移动设备 25 7.2. 业务退订 25 7.2.1. 短信方式 - [SMS-Unregister] 25 7.2.2. 命令方式 26 8. 登陆状态改变 26 8.1. 模式 26 8.2. 请求注册 27 8.2.1. 注册请求消息 - [REG-1] 27 8.2.1.1. 消息格式 27 8.2.1.2. 示例 27 8.2.2. 注册应答消息 - [REG-RSP-1] 28 8.2.2.1. 消息格式 28 8.2.2.2. 错误处理 28 8.2.2.3. 示例 28 8.3. 请求认证 29 8.3.1. 认证请求消息 - [REG-2] 29 8.3.1.1. 消息格式 29 8.3.1.2. 凭据生成算法 29 8.3.1.3. 示例 30 8.3.2. 认证应答消息 - [REG-RSP-2] 30 8.3.2.1. 消息格式 30 8.3.2.2. 错误处理 30 8.3.2.3. 示例 31 8.4. 协商流压缩 31 8.4.1. 协商请求 - [NEG-COMPRESS] 31 8.4.1.1. 消息格式 31 8.4.1.2. 压缩算法 31 8.4.1.3. 示例 32 8.4.2. 协商应答消息 - [NEG-COMPRESS-RSP-2] 32 8.4.2.1. 消息格式 32 8.4.2.2. 错误处理 32 8.4.2.3. 示例 33 8.5. 保持注册 33 8.5.1. 保持注册请求消息 - [REG-3] 33 8.5.1.1. 消息格式 33 8.5.1.2. 示例 33 8.5.2. 保持注册应答消息 - [REG-RSP-3] 34 8.5.2.1. 消息格式 34 8.5.2.2. 示例 34 8.6. 注销 35 8.6.1. 注销请求消息 - [UNREG-1] 35 8.6.1.1. 消息格式 35 8.6.1.2. 示例 35 8.6.2. 注销应答消息 - [UNREG-RSP-1] 36 8.6.2.1. 消息格式 36 8.6.2.2. 错误处理 36 8.6.2.3. 示例 36 8.7. 强制注销通知 36 8.7.1. 通知消息 - [NTF-Registration] 37 8.7.1.1. 消息格式 37 8.7.1.2. 消息体格式 37 8.7.1.3. 消息示例 38 8.7.2. 应答消息 - [NTF-RSP- Registration] 39 8.7.2.1. 消息格式 39 8.7.2.2. 消息示例 39 8.7.2.3. 错误处理 39 9. 订阅-通知 40 9.1. 模式 40 9.2. 联系人列表 40 9.2.1. 订阅联系人列表 40 9.2.1.1. 订阅请求 - [SUB-Contacts] 41 9.2.1.2. 订阅应答 - [SUB-RSP-Contacts] 42 9.2.2. 联系人列表通知 43 9.2.2.1. 通知消息 - [NTF-Contacts] 44 9.2.2.2. 应答消息 - [NTF-RSP-Contacts] 47 9.2.3. 退订联系人列表 49 9.2.3.1. 退订请求 - [UNSUB-Contacts] 49 9.2.3.2. 退订应答 - [UNSUB-RSP-Contacts] 50 9.3. 状态授权信息 50 9.3.1. 订阅状态授权信息 50 9.3.1.1. 订阅请求 - [SUB-ACLs] 51 9.3.1.2. 订阅应答 - [SUB-RSP-ACLs] 52 9.3.2. 授权信息通知 54 9.3.2.1. 通知消息 - [NTF-ACLs] 54 9.3.2.2. 应答消息 - [NTF-RSP-ACLs] 57 9.3.3. 退订授权信息 58 9.3.3.1. 退订请求 - [UNSUB-ACLs] 58 9.3.3.2. 退订应答 - [UNSUB-RSP-ACLs] 59 9.4. 状态订阅申请 60 9.4.1. 订阅状态订阅申请 60 9.4.1.1. 订阅消息 - [SUB-WPending] 60 9.4.1.2. 应答消息 - [SUB-RSP-WPending] 61 9.4.2. 订阅申请通知 63 9.4.2.1. 通知消息 - [NTF-WPending] 63 9.4.2.2. 应答消息 - [NTF-RSP-WPending] 65 9.4.3. 退订状态订阅申请 66 9.4.3.1. 退订请求 - [UNSUB-WPending] 66 9.4.3.2. 退订应答 - [UNSUB-RSP-WPending] 67 9.5. 联系人状态 68 9.5.1. 批量订阅联系人状态 68 9.5.1.1. 订阅请求 - [SUB-Presence-1] 68 9.5.1.2. 订阅应答 - [SUB-RSP-Presence-1] 72 9.5.2. 单个订阅联系人状态 74 9.5.2.1. 订阅请求 - [SUB-Presence-2] 75 9.5.2.2. 订阅应答 - [SUB-RSP-Presence-2] 76 9.5.3. 联系人状态变化通知 77 9.5.3.1. 通知消息 - [NTF-Presence] 77 9.5.3.2. 应答消息 - [NTF-RSP-Presence] 80 9.5.3.3. 错误处理 80 9.5.4. 批量退订联系人状态 81 9.5.4.1. 退订请求 - [UNSUB-Presence-1] 81 9.5.4.2. 退订应答 - [UNSUB-RSP-Presence-1] 82 9.5.5. 单个退订联系人状态 83 9.5.5.1. 退订请求 - [UNSUB-Presence-2] 83 9.5.5.2. 退订应答 - [UNSUB-RSP-Presence-2] 84 10. 系统服务 85 10.1. 模式 85 10.2. 获取用户信息 86 10.2.1. 请求消息 - [SVC-GetUserConfig] 86 10.2.1.1. 消息格式 86 10.2.1.2. 消息体格式 87 10.2.1.3. 消息示例 88 10.2.2. 应答消息 - [SVC-RSP-GetUserConfig] 88 10.2.2.1. 消息格式 88 10.2.2.2. 消息体格式(DeailFlag=5) 89 10.2.2.3. 消息体格式(DeailFlag=3) 92 10.2.2.4. 消息体格式(DeailFlag=1) 93 10.2.2.5. 消息示例 94 10.2.2.6. 错误处理 95 10.3. 添加联系人 95 10.3.1. 请求消息 - [SVC-AddContact] 95 10.3.1.1. 消息格式 95 10.3.1.2. 消息示例 96 10.3.2. 应答消息 - [SVC-RSP-AddContact] 96 10.3.2.1. 消息格式 96 10.3.2.2. 消息示例 96 10.3.2.3. 错误处理 97 10.3.3. 通知消息 - [NTF-AddContact] 97 10.3.3.1. 消息体格式 97 10.3.3.2. 消息体示例 98 10.4. 修改联系人分组 98 10.4.1. 请求消息 - [SVC-SetGroups] 98 10.4.1.1. 消息格式 98 10.4.1.2. 消息示例 99 10.4.2. 应答消息 - [SVC-RSP- SetGroups] 99 10.4.2.1. 消息格式 99 10.4.2.2. 消息示例 100 10.4.2.3. 错误处理 100 10.4.3. 通知消息 - [NTF- SetGroups] 100 10.4.3.1. 消息体格式 100 10.4.3.2. 消息体示例 101 10.5. 状态订阅授权 102 10.5.1. 请求消息 - [SVC-SetACE] 102 10.5.1.1. 消息格式 102 10.5.1.2. 消息示例 103 10.5.2. 应答消息 - [SVC-RSP- SetACE] 103 10.5.2.1. 消息格式 103 10.5.2.2. 消息示例 103 10.5.2.3. 错误处理 104 10.5.3. 通知消息 - [NTF-SetACE] 104 10.6. 删除联系人 104 10.6.1. 请求消息 - [SVC-DeleteContact] 104 10.6.1.1. 消息格式 104 10.6.1.2. 消息示例 105 10.6.2. 应答消息 - [SVC-RSP-DeleteContact] 105 10.6.2.1. 消息格式 105 10.6.2.2. 消息示例 106 10.6.2.3. 错误处理 106 10.6.3. 通知消息 - [NTF-DeleteContact] 106 10.6.3.1. 消息体格式 106 10.6.3.2. 消息体示例 107 10.7. 添加联系人组 107 10.7.1. 请求消息 - [SVC-AddGroup] 107 10.7.1.1. 消息格式 107 10.7.1.2. 消息示例 108 10.7.2. 应答消息 - [SVC-RSP- AddGroup] 108 10.7.2.1. 消息格式 108 10.7.2.2. 消息示例 108 10.7.2.3. 错误处理 109 10.7.3. 通知消息 - [NTF- AddGroup] 109 10.7.3.1. 消息体格式 109 10.7.3.2. 消息体示例 110 10.8. 修改联系人组 110 10.8.1. 请求消息 - [SVC-ModifyGroup] 110 10.8.1.1. 消息格式 110 10.8.1.2. 消息示例 111 10.8.2. 应答消息 - [SVC-RSP-ModifyGroup] 111 10.8.2.1. 消息格式 111 10.8.2.2. 消息示例 111 10.8.2.3. 错误处理 112 10.8.3. 通知消息 - [NTF-ModifyGroup] 112 10.8.3.1. 消息体格式 112 10.8.3.2. 消息体示例 113 10.9. 删除联系人组 113 10.9.1. 请求消息 - [SVC-DeleteGroup] 113 10.9.1.1. 消息格式 113 10.9.1.2. 消息示例 114 10.9.2. 应答消息 - [SVC-RSP- DeleteGroup] 114 10.9.2.1. 消息格式 114 10.9.2.2. 消息示例 114 10.9.2.3. 错误处理 115 10.9.3. 通知消息 - [NTF-DeleteGroup] 115 10.9.3.1. 消息体格式 115 10.9.3.2. 消息示例 115 10.10. 设置显示状态 116 10.10.1. 请求消息 - [SVC-SetPresence] 116 10.10.1.1. 消息格式 116 10.10.1.2. 消息体格式 116 10.10.1.3. 消息示例 117 10.10.2. 应答消息 - [SVC-RSP- SetPresence] 117 10.10.2.1. 消息格式 117 10.10.2.2. 消息示例 118 10.10.2.3. 错误处理 118 10.10.3. 通知消息 - [NTF-Presence] 118 10.11. 修改个人资料 118 10.11.1. 请求消息 - [SVC-UpdateUserConfig] 118 10.11.1.1. 消息格式 118 10.11.1.2. 消息体格式 119 10.11.1.3. 消息示例 120 10.11.2. 应答消息 - [SVC-RSP- SetPresence] 120 10.11.2.1. 消息格式 120 10.11.2.2. 消息示例 121 10.11.2.3. 错误处理 121 10.11.3. 发送改变通知 121 10.12. 获取手机状态 121 10.12.1. 请求消息 - [SVC-GetMobileInfo] 121 10.12.1.1. 消息格式 121 10.12.1.2. 消息体格式 122 10.12.1.3. 消息示例 123 10.12.2. 应答消息 - [SVC-RSP-GetMobileInfo] 123 10.12.2.1. 消息格式 123 10.12.2.2. 消息体格式 124 10.12.2.3. 消息示例 124 10.12.2.4. 错误处理 125 10.13. 随机速配 125 10.13.1. 请求消息 - [SVC-RandomQueryUser] 125 10.13.1.1. 消息格式 125 10.13.1.2. 消息体格式 125 10.13.1.3. 消息示例 126 10.13.2. 应答消息 - [SVC-RSP- RandomQueryUser] 127 10.13.2.1. 消息格式 127 10.13.2.2. 消息体格式 127 10.13.2.3. 消息示例 128 10.13.2.4. 错误处理 129 10.14. 条件速配 129 10.14.1. 请求消息 - [SVC-QueryUser] 129 10.14.1.1. 消息格式 129 10.14.1.2. 消息体格式 130 10.14.1.3. 消息示例 131 10.14.2. 应答消息 - [SVC-RSP-QueryUser] 132 10.14.2.1. 消息格式 132 10.14.2.2. 消息体格式 132 10.14.2.3. 消息示例 133 10.14.2.4. 错误处理 134 10.15. 系统消息 134 10.15.1. 接收消息 - [MSG-SystemMessage] 134 10.15.1.1. 消息格式 134 10.15.1.2. 消息体格式 134 10.15.1.3. 消息示例 135 10.15.2. 应答消息 - [MSG-RSP-SystemMessage] 135 10.15.2.1. 消息格式 135 10.15.2.2. 消息示例 135 10.15.2.3. 错误处理 136 10.16. 退定服务 136 10.16.1. 请求消息 - [SVC-CloseService] 136 10.16.1.1. 消息格式 136 10.16.1.2. 消息体格式 136 10.16.1.3. 消息示例 137 10.16.2. 应答消息 - [SVC-RSP-CloseService] 137 10.16.2.1. 消息格式 137 10.16.2.2. 消息体格式 138 10.16.2.3. 消息示例 139 10.16.2.4. 错误处理 139 10.17. FETION交友服务 140 10.17.1开通Fetion交友服务 – [SVC-RegisterFriendMatching] 140 10.17.2应答消息 – [SVC-RSP-RegisterFriendMatching] 141 10.17.3 关闭Fetion交友服务 – [SVC-UnregisterFriendMatching] 142 10.17.4 应答消息 - [SVC-RSP-UnregisterFriendMatching] 143 10.18. 获取权限信息 145 10.18.1 请求消息 - [SVC-GetPrivacy] 145 10.18.1.1 消息格式 145 10.18.1.2 消息示例 145 10.18.2 应答消息 - [SVC-RSP-GetPrivacy] 145 10.18.2.1 消息格式 145 10.18.2.2 消息体格式 146 10.18.2.3 消息示例 146 10.19. 设置权限消息 147 10.19.1请求消息 - [SVC-SetPrivacy] 147 10.19.1.1消息格式 147 10.19.1.2 消息体格式 147 10.19.1.3 消息示例 148 10.19.2 应答消息 - [SVC-RSP- SetPrivacy] 148 10.19.2.1 消息格式 148 10.19.2.2 消息示例 149 11. 即时消息 150 11.1. 模式 150 11.1.1. 双方邀请 150 11.1.2. 取消邀请 151 11.1.3. 发送与接收 151 11.1.4. 退出会话 152 11.2. 邀请过程 153 11.2.1. UAC 153 11.2.1.1. 请求消息 – [INVITE-IM-UAC] 153 11.2.1.2. 临时应答 – [INVITE-RSP-IM-UAC-Trying] 155 11.2.1.3. 回铃 – [INVITE-RSP-IM-UAC-Ringing] 156 11.2.1.4. 最终应答 – [INVITE-RSP-IM-UAC] 157 11.2.2. UAS 159 11.2.2.1. 请求消息 – [INVITE-IM-UAS] 159 11.2.2.2. 临时应答 – [INVITE-RSP-IM-UAS-Trying] 160 11.2.2.3. 回铃 – [INVITE-RSP-IM-UAS-Ringing] 161 11.2.2.4. 最终应答 – [INVITE-RSP-IM-UAS] 163 11.3. 取消过程 165 11.3.1. UAC 165 11.3.1.1. 请求消息 – [CANCEL-IM-UAC] 165 11.3.1.2. 应答消息 – [CANCEL-RSP-IM-UAC] 166 11.3.2. UAS 167 11.3.2.1. 请求消息 – [CANCEL-IM-UAS] 167 11.3.2.2. 应答消息 – [CANCEL-RSP-IM-UAS] 168 11.4. 确认过程 169 11.4.1. UAC – [ACK-IM-UAC] 169 11.4.1.1. 消息格式 169 11.4.1.2. 消息示例 169 11.4.2. UAS – [ACK-IM-UAS] 170 11.4.2.1. 消息格式 170 11.4.2.2. 消息示例 170 11.4.2.3. 错误处理 170 11.5. 消息传送 171 11.5.1. UAC 171 11.5.1.1. 请求消息 – [MSG-IM-UAC] 171 11.5.1.2. 应答消息 – [MSG-RSP-IM-UAC] 172 11.5.2. UAS 173 11.5.2.1. 请求消息 – [MSG-IM-UAS] 173 11.5.2.2. 应答消息 – [MSG-RSP-IM-UAS] 174 11.6. 结束会话 175 11.6.1. UAC 175 11.6.1.1. 请求消息 – [BYE-IM-UAC] 175 11.6.1.2. 应答消息 – [BYE-RSP-IM-UAC] 176 11.6.2. UAS 177 11.6.2.1. 请求消息 – [BYE-IM-UAS] 177 11.6.2.2. 应答消息 – [BYE-RSP-IM-UAS] 178 11.7. 文件共享 179 11.7.1. 上传文件 179 11.7.2. 发送消息 179 11.7.3. 下载文件 179 12. 语音聊天（IVR） 180 12.1. 模式 180 12.1.1. 流程 180 12.1.2. 取消过程 181 12.2. 邀请过程 182 12.2.1. UAC 182 12.2.1.1. 请求消息 – [INVITE-IVR-UAC] 182 12.2.1.2. 临时应答 – [INVITE-RSP-IVR-UAC-Trying] 184 12.2.1.3. 回铃 – [INVITE-RSP-IVR-UAC-Ringing] 185 12.2.1.4. 最终应答 – [INVITE-RSP-IVR-UAC] 186 12.2.2. UAS 188 12.2.2.1. 请求消息 – [INVITE-IVR-UAS] 188 12.2.2.2. 临时应答 – [INVITE-RSP-IVR-UAS-Trying] 189 12.2.2.3. 回铃 – [INVITE-RSP-IVR-UAS-Ringing] 190 12.2.2.4. 最终应答 – [INVITE-RSP-IVR-UAS] 191 12.3. 取消过程 193 12.3.1. UAC 193 12.3.1.1. 请求消息 – [CANCEL-IVR-UAC] 193 12.3.1.2. 应答消息 – [CANCEL-RSP-IVR-UAC] 194 12.3.2. UAS 195 12.3.2.1. 请求消息 – [CANCEL-IVR-UAS] 195 12.3.2.2. 应答消息 – [CANCEL-RSP-IVR-UAS] 196 12.4. 确认过程 197 12.4.1. UAC – [ACK-IVR-UAC] 197 12.4.1.1. 消息格式 197 12.4.1.2. 消息示例 197 12.4.2. UAS – [ACK-IVR-UAS] 198 12.4.2.1. 消息格式 198 12.4.2.2. 消息示例 198 12.4.2.3. 错误处理 198 12.5. 发起聊天 199 12.5.1. 请求消息 - [SVC-StartVoiceChat] 199 12.5.1.1. 消息格式 199 12.5.1.2. 消息体格式 200 12.5.1.3. 消息示例 201 12.5.2. 应答消息 - [SVC-RSP-StartVoiceChat] 202 12.5.2.1. 消息格式 202 12.5.2.2. 消息体格式 202 12.5.2.3. 消息示例 203 12.5.2.4. 错误处理 203 12.6. 结束会话 203 12.6.1. UAC 203 12.6.1.1. 请求消息 – [BYE-IVR-UAC] 204 12.6.1.2. 应答消息 – [BYE-RSP-IVR-UAC] 205 12.6.2. UAS 206 12.6.2.1. 请求消息 – [BYE-IVR-UAS] 206 12.6.2.2. 应答消息 – [BYE-RSP-IVR-UAS] 207 13. 离线消息 208 13.1. 模式 208 13.2. 发送离线消息 209 13.2.1. 请求消息 - [MSG-SendOfflineMessage] 209 13.2.1.1. 消息格式 209 13.2.1.2. 消息体格式 209 13.2.1.3. 消息示例 210 13.2.2. 应答消息 - [MSG-RSP-SendOfflineMessage] 210 13.2.2.1. 消息格式 210 13.2.2.2. 消息示例 211 13.2.2.3. 错误处理 211 13.3. 获取存储转发消息 211 13.3.1. 请求消息 - [SVC-GetOfflineMessage] 211 13.3.1.1. 消息格式 211 13.3.1.2. 消息示例 212 13.3.2. 应答消息 - [SVC-RSP-GetOfflineMessage] 212 13.3.2.1. 消息格式 212 13.3.2.2. 消息示例 212 13.3.2.3. 错误处理 212 13.4. 接收离线消息 213 13.4.1. 接收消息 - [MSG-OfflineMessage] 213 13.4.1.1. 消息格式 213 13.4.1.2. 消息体格式 213 13.4.1.3. 消息示例 214 13.4.2. 应答消息 - [MSG-RSP-OfflineMessage] 214 13.4.2.1. 消息格式 214 13.4.2.2. 消息示例 214 13.4.2.3. 错误处理 215 14. 短信通道 215 14.1. 获取当前手机号 215 14.1.1. 过程描述 215 14.1.2. 发送格式 – [SMS-QueryPhone] 215 14.1.3. 接收格式 – [SMS-RSP-QueryPhone] 215 14.2. 重设密码 216 14.2.1. 过程描述 216 14.2.2. 发送格式 – [SMS-SetPassword] 216 14.2.3. 接收格式 – [SMS-RSP-SetPassword] 216 14.2.4. 错误码 217 14.3. 离线发送消息- [SMS-MESSAGE] 217 14.4. 获取手机号2 217 14.4.1 过程描述 217 14.4.2 发送格式 – [SMS- QueryPhone2] 217 14.4.3 应答格式 – [SMS-RSP-QueryPhone2] 217 14.5注册短信 218 14.5.1描述 218 14.5.2 发送格式 – [SMS-Register2] 218 14.5.3 应答格式 – [SMS-RSP-Register2] 219 15. 数据通道 219 15.1. 获取导航信息 219 15.1.1. 过程描述 219 15.1.2. 发送格式 - [HTTP-GetConfig] 219 15.1.3. 接收格式 – [HTTP-RSP-GetConfig] 220 15.1.4. 错误码 222 15.2. 获取用户URI 222 15.2.1. 过程描述 222 15.2.2. 发送格式 – [HTTP-GetSipUri] 222 15.2.3. 接收格式 – [HTTP-RSP-GetSipUri] 223 15.2.4. 错误码 223 15.3. 头像上传 223 15.3.1. 过程描述 223 15.3.2. 发送格式 – [HTTP-UploadUserPhoto] 224 15.3.3. 接收格式 – [HTTP-RSP-UploadUserPhoto] 224 15.3.4. 发送头像改变通知 224 15.3.5. 错误码 225 15.4. 头像下载 225 15.4.1. 过程描述 225 15.4.2. 发送格式 – [HTTP-DownloadUserPhoto] 225 15.4.3. 接收格式 – [HTTP-RSP-DownloadUserPhoto] 225 15.4.4. 错误码 226 15.5. 共享文件上传 226 15.5.1. 过程描述 226 15.5.2. 发送格式 – [HTTP-UploadFile] 226 15.5.3. 接收格式 – [HTTP-RSP-UploadFile] 227 15.5.4. 错误码 227 15.6. 共享文件下载 227 16. 即时消息格式 228 16.1. 表情图片 228 16.2. 控制标签 229 16.2.1. 功能描述 229 16.2.2. 标签格式 229 16.2.3. 发送者编码 230 16.2.4. 接收者解码 230 16.3. 文件共享 230 16.3.1. 标签名 230 16.3.2. 功能描述 231 16.4. 文本格式 231 17. 全局错误 231 18. 用户统一状态编码 231 附录1 系统状态码 233 附录2 消息格式索引 233