飞信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