对大街的接口需求Word文档格式.docx

对大街的接口需求Word文档格式.docx

《对大街的接口需求Word文档格式.docx》由会员分享，可在线阅读，更多相关《对大街的接口需求Word文档格式.docx（27页珍藏版）》请在冰点文库上搜索。

cityName

所在城市

schoolName

就读学校

specType

专业类别

specName

专业名称

startEduDate

入学时间

eduLevel

学历

emailIsValidate

邮箱是否验证

2.检查绑定并登录

通过用户id去第三方平台验证用户是否存在，如果验证成功则返回状态信息和用户信息；

如果失败，则通过状态信息返回失败原因。

第三方平台uid

platform

开方平台代码

0人人网

1开心网

2新浪微博

3MSN

4腾讯微博

5XX

optoken

开放平台token（RC4）

opsecret

放平台secret（RC4）

oprefreshtoken

false

开放平台refreshtoken（RC4）

devicetoken

iOSpushtoken（RC4）

corpId

企业id

corpName

企业名称

corpLogo

企业logo

corpDesc

企业简介

isFollowed

是否已关注

recrInfo

招聘信息

semiNum

宣讲会数量

topicNum

讨论区话题数量

concernNum

关注人数

recrStatusList

招聘状态列表

recrStatus

招聘状态

recrDateFrom

状态开始日期

recrDateTo

状态结束日期

recrReached

该状态是否已达到

schoolMateNum

已关注校友数

corpInfo

公司详情

3.绑定第三方开放平台

用户通过输入账号、密码和选择要绑定的平台进行绑定操作。

如果绑定成功，返回状态信息和用户信息；

如果失败，通过状态信息返回失败原因。

开发平台代码

4.注册：

基本信息

用户录入帐号、密码、姓名和手机号码，选择性别进行注册，注册成功以后返回用户id和姓名，如果失败则通过状态信息返回失败原因。

注：

原来已经提供了对应的接口，但是录入项中缺少mobile项。

提示信息

5.注册：

教育信息

用户录入学校名称和专业名称，选择专业类别、入学日期和学历结合用户id注册教育信息，如果成功，返回成功提示，如果失败返回失败原因。

用户id

school

学校名称

入学日期

6.获取企业列表（是指club信息或者公司信息？

）

Ø

用户引导->

名企关注引导：

只需要传入用户在大街网的UID，服务器根据UID查询该用户所在学校和该用户所读专业（是指相同学校“并且”相同专业还是“或”的关系？

）中同学关注最多的20个名企，如数量不足20个，则读取该用户所读专业关注最多的前20家企业。

（searchType=0）

校园招聘->

搜索：

通过组合输入2个参数：

城市和企业名称（企业信息中并无城市信息，企业名称在下面表格中的输入参数中并未列出），查询出所有符合条件的企业，需要支持翻页。

（searchType=1）

我的关注（searchType=2）

我的关注->

引导关注（同：

用户引导->

名企关注引导）（searchType=0）

添加名企，按地区（企业信息中无地区信息）、行业、企业类型（企业类型是指？

）搜（searchType=1）

搜索（searchType=1）（是否与上述冲突）

查询成功返回企业列表信息和状态信息，如果失败通过状态信息返回失败原因。

业务规则

按照条件筛选出对应的企业，返回的企业列表按照企业当前招聘数量（招聘多的排前面）、关注人数（关注人数多的在前面）进行排序。

其中宣讲会的数量只统计当前还未结束的宣讲会、讨论区话题数量只返回与当前有效的招聘信息有关的话题数量。

pageNo

页码

pageSize

每页数量

searchType

搜索类型：

0=名企关注引导

1=搜索

2=我的关注

industry

所属行业

district

地区

corpType

企业类型

后四项不会同时为空。

返回数据

corpList（什么类型）

用户关注企业列表

企业招聘所在城市

其中公司详情可能需要重新考虑，如果公司详情数据过大，可以提取到获取企业详细信息中进行再获取，否则可以直接去掉获取企业详情信息接口。

公司简介是不是公司详情的前部分？

（公司简介在哪里？

？

7.获取企业详细信息

根据当前用户的id和企业id获取企业详细信息。

如果成功返回企业详细信息和状态信息，如果失败通过状态信息返回失败原因。

原来已经提供了很接近的接口，但是输入参数中缺少“用户id”。

corpList

是否已经关注

0否

1是

已关注的校友数

原功能接口返回的参数中缺少“是否关注”和“已关注的校友数”两个字段的值。

8.保存关注企业

通过用户id和企业id进行关联，实现个人关注企业，如果成功返回成功状态信息，如果失败返回失败的原因。

followList

关注列表

9.获取招聘信息

获取招聘信息分为一下四种情况：

获取最新招聘信息；

根据用户id获取该用户同学校被关注企业版的招聘信息；

根据用户id获取该用户同专业被关注企业版的招聘信息（searchType=2）；

按照地区和企业名称查询招聘信息（searchType=3）。

查询成功返回招聘信息和状态信息，如果失败通过状态信息返回失败原因。

按照“招聘信息发布时间”倒序排列，且只返回当前有效的招聘信息。

注意事项

无

0=最新消息

1=同校关注

2=同专业关注

3=搜索

searchType=1或2时必选

searchType=3时生效

城市名称

是否关注了该企业

logo

recrCity

recrId

校园招聘id

recrTitle

招聘信息标题

recrPubTime

招聘信息发布时间

isRead

是否已读（什么意思？

是指项目邀约信息已读吗？

10.获取宣讲会列表

获取宣讲会信息分为一下四种情况：

根据用户id获取本校的宣讲会信息（searchType=0）；

根据用户id获取同城的宣讲会信息（searchType=1）；

根据城市和企业名称查询宣讲会信息（searchType=2）；

根据企业id获取该企业的宣讲会信息（searchType=3）。

如果成功则返回宣讲会信息和状态信息，如果失败，则通过状态信息返回失败原因。

返回还未开始的宣讲会信息，按照“宣讲会开始时间”正序排列。

查询类型

0-本校

1-同城

2-搜索

3-列出企业下的宣讲会

searchType=2生效

城市

searchType=3必选

semiId

宣讲会id

semiTitle

宣讲会标题

startTime

宣讲会开始时间

yyyy-mm-ddhh:

mm:

ss

endTime

宣讲会结束时间

semiLocation

宣讲会地点

registerNum

报名人数

isCooperated

是否合作企业（什么为合作企业？

applyUrl

网申地址

isRegistered

是否报名

semiInfo

宣讲会详情

如果获取宣讲会列表中不存在大数据项，那么就可以省去“18获取宣讲会详细信息”接口功能，有待讨论确定。

11.获取宣讲会详细信息

根据用户id和宣讲会id查询对应的宣讲会详细信息，返回宣讲会的对应的详细信息。

如果失败通过状态信息返回失败原因。

是否合作企业

12.宣讲会报名

用户输入手机号，系统结合用户id和宣讲会id完成报名操作，报名成功，返回提示信息；

如果报名失败，则返回失败原因。

手机号

已到达报名人数上线

13.获取讨论话题列表

根据企业的id，返回对应企业相关的讨论话题列表信息。

按照讨论话题“发布时间”倒序排列后返回数据。

页面

每页显示的记录数

topicId

话题id

topicTitle

标题

content

正文

pubTime

发布时间

topicType

话题类型：

0=笔经、1=面经、2=薪酬

author

作者

authorPicture

14.获取讨论话题回复信息

根据话题id，获取该话题的所有回复信息。

按照回复信息“发布时间”倒序排列返回数据。

answerId

回复id

answerTitle

标题（回复没有标题）

answerTo

回复给

15.发表讨论话题

用户选择对应的企业，录入话题标题和正文，并选择话题的类型，发表新的话题。

如果发表成功，返回成功信息；

如果发表失败，则返回失败原因。

0=无分类、1=笔经、2=面经、3=薪酬

16.发表回复

用户选择要回复的话题和回复的对象，录入回复的标题和正文进行回复。

如果回复成功则提示回复成功；

如果回复失败返回失败原因。

17.获取攻略信息（攻略是指什么？

根据企业的id返回企业的攻略信息。

如果成功返回攻略信息和状态信息，如果失败通过状态信息返回失败原因。

strategyId

攻略id

strategyTitle

url

下载地址

fileName

文件名

18.邮件转发攻略信息（邮件格式以及内容是什么？

根据用户id获取和攻略id，给对应的用户的邮箱发送攻略信息。

如果失败通过状态信息返回失败原因

19.获取消息列表

根据用户id获取当前用户的消息列表信息和转台信息。

按照消息“发布时间”倒序排列后返回数据。

messageId

messageTitle

receiveTime

messageType

消息类型：

0=发布宣讲会

1=发布攻略

2=校招信息发布\更新

3=招聘进展状态

4=讨论区的回复

5=职位邀请

6=宣讲会邀请

7=项目型邀请

是否阅读0=未读1=已读

20.设信息为已读

根据对应的用户id和消息id把对应的消息设置为已读。

如果设置成功，返回提示信息；

如果设置失败，返回失败原因。

消息id

21.修改用户基本信息

用户可以对用户的姓名、头像、email、性别、手机、所在城市、就读学校、专业名称，选择专业类别、入学时间和学历，修改以后进行保存。

如果保存成功，则返回成功信息；

如果保存失败，返回失败原因。

22.更改头像

根据用户id和新头像文件对用户的头像进行修改。

传递方式

默认值

form

23.判断某人是否关注某企业

根据当前用户的id和企业id获取判断某人是否关注此公司

Result

True：

关注

False：

未关注

24.获取某公司的话题类型

根据企业id获取该企业的话题类型