网站外部接口使用说明书
- 格式：doc
- 大小：562.50 KB
- 文档页数：16
网站外部接口使用说明书目录介绍 (1)数据模型 (1)1.用户 (1)2.职位 (1)3.简历 (2)接口说明 (2)1.职位发布接口IssueJob (2)2.职位暂停接口PauseJob (3)3.职位删除接口DeleteJob (4)4.应聘的简历列表GetApplyCv (4)5.职位的推荐简历列表GetRecommendCv (5)6.查看简历内容GetCvInfo (6)示例说明（以发布职位为例） (8)1.C#示例 (8)附录-参数约定 (9)1.学历要求EducationID： (9)2.工作经验Experience (9)3.最低月薪SalaryID： (10)4.职位类别JobTypeID： (10)介绍为了提高企业的招聘效率，满足企业构建自己内部招聘平台的需求，本站对注册企业提供外部接口。
接口包括职位发布、职位修改、职位暂停、获取简历列表、获取推荐的简历列表、获取简历内容等。
数据模型1.用户每一个注册企业都有自己的用户信息，包括用户名，密码等。
所有的接口均通过用户名和密码来验证用户的合法性。
2.职位企业可以在人才网上发布职位，职位的内容包括职位名称主要职位类别、需要人数、工作地点、岗位职责、岗位要求、学历要求、相关工作经验、最低月薪以及截止时间。
职位相关的操作为：发布职位、更新职位、暂停职位、删除职位。
3.简历企业可以在人才网上查看职位，包括求职者的基本信息，联系方式等。
职位相关的操作为：获取职位相关的简历列表、获取推荐的简历列表、查看简历内容。
接口说明1.职位发布接口IssueJobUrl:/open/webservice.asmx?op=IssueJob请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符String，<50字符OldJobName 如果空，函数功能为发布新职位；如果不为空，函数功能为修改职位，OldJobName为要修改的职位名称。
String，2~50字符JobName 如果OldJobName为空，函数功能为发布新职位，JobName为新添加的职位名称；如果OldJobName不为空，JobName要修改的职位的新名称。
JobTypeID 主要职位类别Int，见附录NeedNumber 需要人数Int，大于等于0，如果是0则表示不限Region 工作地点省市区，写全名，如山东省莱芜市莱城区，或山东省莱芜市EducationID 学历要求Int，见附录Experience 相关工作经验（年）Int，见附录SalaryID 最低月薪Int，见附录EndDate 截止时间String,格式‘2014-09-09’。
如果为空则是今天加上两个月之后的日期Responsibility 岗位职责String，20~2000字符Demand 岗位要求String，20~2000字符输出参数：返回值参数状态说明1 修改成功。
0 未知错误。
–1 用户名密码错误。
–2 职位名称长度不符合要求。
–3 与本公司发布的其他职位重名。
-4. 职位类别错误。
-5 工作地点不存在。
–6 需要人数错误。
–7 岗位职责内容为空或者长度不符合要求。
–8 岗位要求内容为空或者长度不符合要求。
-9. 学历要求错误。
-10 相关工作经验错误。
–11 超过了本公司可以发布职位的个数。
–12 最低月薪错误。
–13 截止时间错误或者早于当前时间。
-14. 未找到该职位。
返回结果格式·成功<string>1</string>·失败<string>-1</string>2.职位暂停接口PauseJobUrl:/open/webservice.asmx?op=PauseJob 请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符JobName 要暂停的职位名称String，<50字符输出参数：返回值参数状态说明1 暂停职位成功。
0 未知错误–1 用户名密码错误。
-2. 职位名称为空或者超过50字符。
-3 未找到该职位返回结果格式·成功<string>1</string>·失败<string>-1</string>3.职位删除接口DeleteJobUrl:/open/webservice.asmx?op=deleteJob 请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符JobName 要删除的职位名称String，<50字符输出参数：输出返回值参数状态说明1 删除职位成功。
0 未知错误。
–1 用户名密码错误。
-2. 职位名称为空或者超过50字符。
-3 未找到要删除的职位。
返回结果格式·成功<string>1</string>·失败<string>-1</string>4.应聘的简历列表GetApplyCvUrl:/open/webservice.asmx?op=GetApplyCv 请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符JobName 职位名称，如果为空则是所有职位String，<50字符PageNumber 页号，每一页20个Int，大于0的正整数StartDate 要搜索的时间范围起始值（简历投递时间）String，格式‘2014-09-09’。
如果为空则是今天之前两个月的日期，如今天是2014-09-09，则StartDate为2014-07-09。
EndDate 要搜索的时间范围结束值（简历投递时间）String，格式‘2014-09-09’。
如果为空则是当前日期。
输出参数：错误输出返回值状态说明0 未知错误。
–1 用户名密码错误。
-2. 职位名称为空或者超过50字符。
-3 未找到要查询的职位。
-4 StartData格式不正确。
-5 EndDate格式不正确。
-6 查询开始时间不能晚于结束时间。
-7 页数必须是大于0的正整数。
返回结果格式·成功<Table diffgr:id="Table1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <CvID>24392518</CvID>//简历ID<JobName>销售</JobName>//投递的职位名称<Gender>女</Gender><Degree>大专</Degree><Age>30</Age><Experience>4</Experience><LivePlace>北京市朝阳区</LivePlace>//所在地</Table>·失败<Table diffgr:id="Table1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <Result>-4</Result></Table>5.职位的推荐简历列表GetRecommendCvUrl:/open/webservice.asmx?op=GetRecommendCv请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符JobName 职位名称String，<50字符pageNumber页号,每页20个Int，大于0的正整数输出参数：错误输出返回值状态说明0 未知错误。
–1 用户名密码错误。
-2. 职位名称为空或者超过50字符。
-3 未找到要查询的职位。
-4 页数必须是大于0的正整数。
返回结果格式·成功<Table diffgr:id="Table1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <CvID>21527189</CvID>//简历ID<JobName>工地建设</JobName>//现职位<Gender>女</Gender><Degree>大专</Degree><Age>57</Age><Experience>11</Experience>//工作经验<LivePlace>北京市丰台区</LivePlace>//所在地</Table>·失败<Table diffgr:id="Table1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <Result>-4</Result></Table>6.查看简历内容GetCvInfoUrl:/open/webservice.asmx?op=GetCvInfo请求方式:Get,Post输入参数：参数说明类型UserName 账号String，<50字符Password 密码String，<50字符CvID 简历ID Int输出参数：错误输出返回值状态说明0 未知错误。
–1 用户名密码错误。
-2 该简历不存在。
-3 该求职者已经把简历隐藏，获取失败。
-4 该简历不能显示，可能的原因如下：可能存在不合适的信息返回结果格式·成功<Cv xmlns:xsi="/2001/XMLSchema-instance"xmlns:xsd="/2001/XMLSchema" xmlns="/"><Result>1</Result>//返回结果<CvInfo><BasicInfo>//基本信息<CvID>24464065</CvID>//简历ID<Name>张三</Name><RelatedWorkYears>0</RelatedWorkYears><LivePlace>山东省青岛市崂山区</LivePlace>//所在地<AccountPlace>山东省泰安市</AccountPlace>//户口所在地<Email>******</Email>//如没有权限，则显示星号<Mobile>******</Mobile><Speciality>工作能力</Speciality> //工作能力<Age>29</Age></BasicInfo><JobIntention>//求职意向<JobType>教育/培训行政/后勤</JobType>//求职意向的工作类型。
