嫁我网卓望合作接口规范

M-TIME

嫁我网嫁我网卓望合作接口规范

版本0.1

修订历史记录

目录

1.简介 (4)

1.1目的 (4)

1.2使用对象 (4)

2.接口约定 (5)

2.1基本约定 (5)

2.2HTTP HEADERS (5)

2.3请求方式 (5)

2.4响应方式 (5)

2.5请求验证和会员ID信息 (6)

2.6请求地址 (6)

3.数据接口 (6)

3.1登录注册 (6)

3.1.1登录 (6)

3.1.2注册 (7)

3.2信件 (8)

3.2.1取得信件信息 (8)

3.3个人中心 (8)

3.3.1取得会员的基本信息 (8)

3.3.2完善资料 (10)

3.3.3修改密码 (11)

3.3.4更新个人独白 (11)

3.3.5取得会员的征友条件 (12)

3.3.6更新会员的征友条件 (13)

3.3.7取得会员相片 (14)

3.3.8修改征友状态 (15)

3.3.9取得会员的相片公开模式 (16)

3.3.10修改相片公开模式 (17)

3.4有缘人 (17)

3.4.1黑名单 (17)

3.5谁合眼缘 (22)

3.6搜索 (22)

3.7其他 (23)

3.7.1取得选项数据 (23)

4.选项对照表 (24)

5.请求代号定义 (25)

6.错误代号定义 (25)

嫁我网卓望合作接口规范

1.简介

1.1目的

本规范制定了访问嫁我网平台的接口规范，目的是帮助卓望科技的开发人员开发出可以与嫁我网进行交互的系统。

1.2使用对象

卓望科技的开发人员。

2.接口约定

2.1基本约定

1.所有XML消息中的字段均为小写，单词之间用连接符（-）进行连接，比如：member-id 。

2.所有消息中的XML数据均采用utf-8编码

3.所有接口消息大小不得超过500k.

4.所有字段采用网络字节序填写。

2.2HTTP HEADERS

接口数据使用HTTP协议传递, 在访问marry5的数据接口时,需要在请求的HTTP HEADERS 里的Host加入指定的接口URL 域名;

2.3请求方式

客户端向嫁我网发送xml 数据，格式为：

属性type 为业务逻辑的业务代号，详见对照表。

2.4响应方式

嫁我网使用xml 格式响应请求结果，格式为：

response 的属性result 只有两个值：1 和-1 。

1 表示业务操作成功，-1 表示业务操作失败。

当result 的值为1 时，响应的内容内将包含业务数据。比如：注册成功后，嫁我网返回会员ID

12345678

当result 的值为-1 时，响应的内容内会附上操作失败的详细代号和说明。比如：

101

邮箱已被他人使用

注意：由于操作失败响应的是固定的格式，所以在后面的接口规约中，只对成功响应作描述。

2.5请求验证和会员ID信息

客户端须在请求的头信息中包含两个信息：auth和memberid，auth为双方达成共识的加密信息，memberid为本次请求的会员ID。

2.6请求地址

https://www.wendangku.net/doc/b1439160.html,/

3.数据接口

3.1登录注册

3.1.1登录

3.1.1.1请求

123123

888888

3.1.1.2响应

成功登录

3.1.2注册

3.1.2.1请求

name@https://www.wendangku.net/doc/b1439160.html,

137********

1

123123

123123

3.1.2.2响应

成功注册

123123

3.2信件

3.2.1取得信件信息

3.2.1.1请求

3.2.1.2响应

10

3.3个人中心

3.3.1取得会员的基本信息

3.3.1.1请求

123456

3.3.1.2响应

1

member nick

2009-9-23 20:01:23 80.12

今天的心情真不错

6

68

26

1983-07-13

2

175

1

个人独白

形象照绝对路径

10

2

1

3.3.2完善资料

3.3.2.1请求

6

68

1980-01-01

178

2

1

2

3.3.2.2响应

成功更新

3.3.3修改密码

3.3.3.1请求

123123

456456

456456

3.3.3.2响应

成功修改密码

3.3.4更新个人独白

3.3.

4.1请求

123123

3.3.

4.2响应

成功修改个人独白

3.3.5取得会员的征友条件

3.3.5.1请求

123456

3.3.5.2响应

25

25

165

175

2

1

1

2

0

6

68

3.3.6更新会员的征友条件

3.3.6.1请求

25

25

165

175

2

1

1

2

0

6

68

3.3.6.2响应

成功更新了征友条件

3.3.7取得会员相片

3.3.7.1请求

1

9

3.3.7.2响应

123123

25

178

…

3.3.8修改征友状态

3.3.8.1请求

1

3.3.8.2响应

成功修改征友状态

3.3.9取得会员的相片公开模式

3.3.9.1请求

1

3.3.9.2响应

1 123456

3.3.10修改相片公开模式

3.3.10.1请求

1

123456

3.3.10.2响应

成功修改照片公开模式

3.4有缘人

3.4.1取得黑名单列表

3.4.1.1请求

1

10

3.4.1.2响应

123123

membera

25

178

2

123123

memberb

25

178

3

…

3.4.2取得收藏会员列表

3.4.2.1请求

1

10

3.4.2.2响应

123123

membera

25

178

2

2009-09-30 17:11:22

3.4.3取得谁浏览过我列表

3.4.3.1请求

1

10

3.4.3.2响应

123123

membera

25

178

2

2009-09-30 17:11:22