《对大街的接口需求供参考》由会员分享，可在线阅读，更多相关《对大街的接口需求供参考（20页珍藏版）》请在金锄头文库上搜索。
1、对大街的接口需求1. 登录功能描述用户通过输入账号和密码登录。如果登录成功，返回用户信息；如果失败，返回失败的原因。输入参数参数名必选说明emailtrue登录账号passwordtrue登录密码返回数据变量含义resulttrue-成功false-失败message提示信息：比如：没有这个用户，密码错误等提示uid大街网用户idname姓名userPicture头像emailemailgender性别mobile手机cityName所在城市schoolName就读学校specType专业类别specName专业名称startEduDate入学时间eduLevel学历emailIsValida
2、te邮箱是否验证2. 检查绑定并登录功能描述通过用户id去第三方平台验证用户是否存在，如果验证成功则返回状态信息和用户信息；如果失败，则通过状态信息返回失败原因。输入参数参数名必选说明uidtrue第三方平台uidplatformtrue开方平台代码0 人人网1 开心网2 新浪微博3 MSN 4 腾讯微博5 百度optokentrue开放平台token（RC4）opsecrettrue放平台secret（RC4）oprefreshtokenfalse开放平台refreshtoken（RC4）devicetokenfalseiOSpushtoken（RC4）返回数据变量含义resulttrue-
3、成功false-失败message提示信息：比如：没有这个用户，密码错误等提示corpId企业idcorpName企业名称corpLogo企业logocorpDesc企业简介isFollowed是否已关注recrInfo招聘信息semiNum宣讲会数量topicNum讨论区话题数量concernNum关注人数recrStatusList招聘状态列表recrStatus招聘状态recrDateFrom状态开始日期recrDateTo状态结束日期recrReached该状态是否已达到schoolMateNum已关注校友数corpInfo公司详情3. 绑定第三方开放平台功能描述用户通过输入账号、密码
4、和选择要绑定的平台进行绑定操作。如果绑定成功，返回状态信息和用户信息；如果失败，通过状态信息返回失败原因。输入参数参数名必选说明emailtrue登录账号passwordtrue登录密码platformtrue开发平台代码0 人人网1 开心网2 新浪微博3 MSN 4 腾讯微博5 百度optokentrue开放平台token（RC4）opsecrettrue放平台secret（RC4）oprefreshtokenfalse开放平台refreshtoken（RC4）devicetokenfalseiOSpushtoken（RC4）返回数据变量含义resulttrue-成功false-失败mess
5、age提示信息：比如：没有这个用户，密码错误等提示uid大街网用户idname姓名userPicture头像emailemailgender性别mobile手机cityName所在城市schoolName就读学校specType专业类别specName专业名称startEduDate入学时间eduLevel学历emailIsValidate邮箱是否验证4. 注册：基本信息功能描述用户录入帐号、密码、姓名和手机号码，选择性别进行注册，注册成功以后返回用户id和姓名，如果失败则通过状态信息返回失败原因。输入参数参数名必选说明emailtrue登录账号passwordtrue登录密码nametrue
6、姓名gendertrue性别mobiletrue手机注：原来已经提供了对应的接口，但是录入项中缺少mobile项。返回数据变量含义resulttrue-成功false-失败message提示信息uid大街网用户idname姓名5. 注册：教育信息功能描述用户录入学校名称和专业名称，选择专业类别、入学日期和学历结合用户id注册教育信息，如果成功，返回成功提示，如果失败返回失败原因。输入参数参数名必选说明uidtrue用户idschooltrue学校名称specTypetrue专业类别specNametrue专业名称startEduDatetrue入学日期eduLeveltrue学历返回数据变量含
7、义resulttrue-成功false-失败message提示信息6. 获取企业列表（是指club信息或者公司信息？）功能描述 用户引导-名企关注引导：只需要传入用户在大街网的UID，服务器根据UID查询该用户所在学校和该用户所读专业（是指相同学校“并且”相同专业还是“或”的关系？）中同学关注最多的20个名企，如数量不足20个，则读取该用户所读专业关注最多的前20家企业。(searchType=0) 校园招聘-搜索：通过组合输入2个参数：城市和企业名称（企业信息中并无城市信息，企业名称在下面表格中的输入参数中并未列出），查询出所有符合条件的企业，需要支持翻页。(searchType=1) 我的
8、关注(searchType=2) 我的关注-引导关注 (同：用户引导-名企关注引导)(searchType=0) 我的关注-添加名企，按地区（企业信息中无地区信息）、行业、企业类型（企业类型是指？）搜(searchType=1) 我的关注-搜索(searchType=1)（是否与上述冲突）查询成功返回企业列表信息和状态信息，如果失败通过状态信息返回失败原因。业务规则按照条件筛选出对应的企业，返回的企业列表按照企业当前招聘数量（招聘多的排前面）、关注人数（关注人数多的在前面）进行排序。其中宣讲会的数量只统计当前还未结束的宣讲会、讨论区话题数量只返回与当前有效的招聘信息有关的话题数量。输入参数参数
9、名必选说明pageNofalse页码pageSizefalse每页数量searchTypetrue搜索类型：0=名企关注引导1=搜索2=我的关注uidfalse用户idindustryfalse所属行业districtfalse地区corpTypefalse企业类型注：后四项不会同时为空。返回数据 变量含义resulttrue-成功false-失败message提示信息corpList（什么类型）用户关注企业列表corpId企业idcorpName企业名称corpLogo企业logocityName企业招聘所在城市corpDesc企业简介isFollowed是否已关注recrInfo招聘信息s
10、emiNum宣讲会数量topicNum讨论区话题数量concernNum关注人数recrStatusList招聘状态列表recrStatus招聘状态recrDateFrom状态开始日期recrDateTo状态结束日期recrReached该状态是否已达到schoolMateNum已关注校友数corpInfo公司详情其中公司详情可能需要重新考虑，如果公司详情数据过大，可以提取到获取企业详细信息中进行再获取，否则可以直接去掉获取企业详情信息接口。公司简介是不是公司详情的前部分？（公司简介在哪里？）7. 获取企业详细信息功能描述根据当前用户的id和企业id获取企业详细信息。如果成功返回企业详细信息和
11、状态信息，如果失败通过状态信息返回失败原因。输入参数参数名必选说明uidtrue用户idcorpIdtrue企业id注：原来已经提供了很接近的接口，但是输入参数中缺少“用户id”。返回数据变量含义resulttrue-成功false-失败message提示信息corpList用户关注企业列表corpId企业idcorpName企业名称corpLogo企业logocityName企业招聘所在城市isFollowed是否已经关注0否1是schoolMateNum已关注的校友数corpInfo公司详情recrInfo招聘信息注：原功能接口返回的参数中缺少“是否关注”和“已关注的校友数”两个字段的值。
12、8. 保存关注企业功能描述通过用户id和企业id进行关联，实现个人关注企业，如果成功返回成功状态信息，如果失败返回失败的原因。输入参数参数名必选说明uidtrue用户idfollowListtrue关注列表返回数据变量含义resulttrue-成功false-失败message提示信息9. 获取招聘信息功能描述获取招聘信息分为一下四种情况： 获取最新招聘信息； 根据用户id获取该用户同学校被关注企业版的招聘信息；（searchType=1） 根据用户id获取该用户同专业被关注企业版的招聘信息（searchType=2）； 按照地区和企业名称查询招聘信息（searchType=3）。查询成功返回
13、招聘信息和状态信息，如果失败通过状态信息返回失败原因。业务规则按照“招聘信息发布时间”倒序排列，且只返回当前有效的招聘信息。输入参数参数名必选说明注意事项pageNotrue页码无pageSizetrue每页数量无searchTypetrue搜索类型：0=最新消息1=同校关注2=同专业关注3=搜索无uidfalse用户idsearchType=1或2时必选corpNamefalse企业名称searchType=3时生效cityNamefalse城市名称searchType=3时生效返回数据变量含义resulttrue-成功false-失败message提示信息corpId企业idcorpName企业名称isFollowed是否关注了该企业logo企业logorecrCity
