招聘网站API接口开发文档

1、北京智信泰科科技有限公司 版权所有招聘网站API接口开发文档v1.2北京智信泰科科技有限公司Tel: 010 5714 2206Cell: 180 0126 3511Issued：2012.11.18目录1.搜索附近职位31.1请求流程图31.2调用方式1参数address（地址）和distance（范围）41.2.1获取职位数量接口41.2.2获取职位信息接口41.2.3 参数说明41.2.4 接口举例41.2.5 get_groupnum数量接口返回值51.2.6 result视图返回XML数据格式实例51.3调用方式2参数在1.2的基础上加入keyword（关键字）71.3.1获取职位数

2、量接口71.3.2获取职位信息接口71.3.3 参数说明71.3.4 接口举例81.3.5 get_groupnum数量接口返回值81.3.6 result视图返回XML数据格式实例81.4调用方式3参数longitude(经度)、latitude（纬度）、和distance（范围）101.4.1获取职位数量接口101.4.2获取职位信息接口101.4.3 参数说明101.4.4 接口举例111.4.5 get_groupnum数量接口返回值111.4.6 result视图返回XML数据格式实例111.5调用方式3参数longitude(经度)、latitude（纬度）、keyword（关键字

3、）和distance（范围）131.5.1获取职位数量接口131.5.2获取职位信息接口131.5.3 参数说明131.5.4 接口举例131.5.5 get_groupnum数量接口返回值141.5.6 result视图返回XML数据格式实例141.6更多参数调用161.6.1获取职位数量接口161.6.2获取职位信息接口161.6.3 所有调用接口举例161.6.4 所有参数说明表171.5.6 result数据接口返回xml结构表格说明172 有聚合时根据fid获取对应招聘信息XML数据格式182.1接口举例182.2参数说明182.3 content视图返回XML数据格式实例182.4

4、 content数据接口返回xml结构表格说明20版本号v1.2发布日期2012-11-18开发者北京智信泰科科技有限公司编写者北京智信泰科科技有限公司Support emailzxtk_supportSupport Cellphone180 0126 3511修订记录2012-11-18 重新修订文档（文字整理）2012-10-16 增加薪资区间搜索参数salary_min、salary_max2012-09-09 发布v1.0版本1. 搜索附近职位招聘搜索服务端接收客户端的查询请求，将查询请求发送给搜索引擎进行检索，搜索引擎会将检索到的结果以字符流的方式返回给招聘搜索服务端。招聘搜索服务端

5、会将从搜索引擎端接收到的信息匹配不同的职位信息和每条职位信息的多个栏位，然后以XML数据格式返回给手机客户端。1.1请求流程图客户端程序提交查询请求服务端接收查询请求后返回信息第一次发送获取职位数量请求返回搜索到的招聘信息总数第二次发送请求，并指定起始位置和数量以xml数据格式返回职位招聘信息1.2调用方式1参数address（地址）和distance（范围）1.2.1获取职位数量接口1.2.2获取职位信息接口1.2.3 参数说明1）地址：参数名称address，字符串类型，含义详细的地理位置，如：北京市中关村；汉字需要是utf-8编码；2）范围：参数名称distance，double类型，含

6、义是以上面的地址为中心的搜索范围，以公里为单位，如果想查询500米、1公里或5公里范围内的职位，参数值对应为0.5、1或5（不必写“公里”这两个汉字）；3）起始位置：参数名称start，int类型，含义是从数据的第n个位置开始获取数据，数据的起始位置为1；4）返回数量：参数名称quantity，int类型，含义是返回的数据数量，start和quantity参数共同使用可以完成翻页功能；1.2.4 接口举例搜索以“北京市中关村”为地址，1公里范围内的职位；1）首先要获取职位的数量，以便在客户端实现分页显示功能；例如：注意，中文地址名称需要是utf-8编码，编码转换后的接口为： 2）然后，再发送获

7、取职位信息接口请求；编码转换后的接口为： 注意：获取数量接口和信息接口的address和distance参数值必须相同。1.2.5 get_groupnum数量接口返回值1）正确返回数量值，如：100；表示根据发送的参数查询到的数据的数量；如果返回值为0的话，说明根据参数没有查询到相关数据；2）错误返回errorcode，表示地址参数输入错误，未查到此地址信息；1.2.6 result视图返回XML数据格式实例 一条xml数据结构：-<product>  <website>赶集网招聘</website>   <job_

8、name>搜索引擎 分词算法工程师</job_name>   <release_time>2012-10-08</release_time>   <description>职位描述：【招聘要求】1、计算机或通信类相关专业，大专以上学历，有C/C+/Java应用开发经验；2、对搜索或中文分词算法有经验或有兴趣；或对Hadoop有了解；3、学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神；4、本公司有多个职位招聘，投递简历时请注明应聘职位。</description>

9、;   <email>zxtk_hr</email>   <comment />   <salary>面议</salary>   <view_num>0</view_num>   <headcount>若干</headcount>   <comment_num>0</comment_num>   <pic_link>6/pic_link/zxtk

10、-default.jpg</pic_link>   <http_link> </http_link>   <address>北京市海淀区中关村东路18号财智国际大厦C-1609</address>   <telphone />   <company_introduction>公司简介：北京智信泰科科技有限公司是成立于北京中关村园区的高科技企业，专注于移动互联网的技术开发和服务。公司战略定位为：立足于移动信息市场，以3G发展为契机，以移动互联网为方向，以移动计算、移动存储、

11、嵌入式开发、移动数据通信等技术为手段，为客户提供实用新颖的移动信息产品与服务。</company_introduction>   <longitude>123.391263</longitude>   <latitude>41.808599</latitude>   <city />   <website_num>10</website_num>   <fids>4728 4735 4851 8580 9859 26448 26675 2

12、6799 32601 32788</fids>   <salary_range>3000.00 3000.00</salary_range>   <type>计算机/网络/通信招聘</type>   <company>北京智信泰科科技有限公司</company> </product>对以上返回的XML数据格式的介绍：标签名称标签介绍Website招聘信息发布网站job_name职位名称release_time发布时间Description职位描述Email

13、接收简历的email地址Comment评论Salary职位薪资view_num招聘信息的浏览次数Headcount招聘人数comment_num招聘信息的评论次数pic_link相关图片链接http_link发布网站的招聘信息链接Address公司地址Telephone公司电话company_introduction公司介绍Longitude公司地址的经度Latitude公司地址的纬度City公司所在城市website_num发布同一职位的公司数量 或 同一公司在不同网站发布职位的总数Fids聚合内容的idsalary_range薪资区间Type招聘信息类别Company招聘公司的名称1.3调

14、用方式2参数在1.2的基础上加入keyword（关键字）1.3.1获取职位数量接口1.3.2获取职位信息接口1.3.3 参数说明1）地址：参数名称address，字符串类型，含义详细的地理位置，如：北京市中关村；需要进行utf-8编码；2）范围：参数名称distance，double类型，含义是以上面的地址为中心搜索范围内的职位信息，以公里为单位，如果想查询500米、1公里或5公里范围内的职位，参数值对应为0.5、1或5；3）关键字：参数名称keyword，字符串类型，含义是与职位相关的职位名称或职位类型，需要进行utf-8编码；4）起始位置：参数名称start，int类型，含义是从数据的第n

15、个位置开始获取数据，数据的起始位置为0；5）返回数量：参数名称quantity，int类型，含义是返回的数据数量，start和quantity参数共同使用可以完成翻页功能；1.3.4 接口举例搜索以“北京市中关村”为地址，1公里范围内的职位；1）首先要获取职位的数量，以便在客户端实现分页显示功能；例如：注意，中文要进行utf-8编码，编译后的接口为： 2）然后，再发送获取职位信息接口请求；编译后的接口例如： 注意：获取数量接口和信息接口的参数值必须 1.3.5 get_groupnum数量接口返回值1）正确返回数量值，如：100；表示根据发送的参数查询到的数据的数量；如果返回值为0的话，说明根

16、据参数没有查询到相关数据；2）错误返回errorcode，表示地址参数输入错误，未查到此地址信息；1.3.6 result视图返回XML数据格式实例 一条xml数据结构：-<product>  <website>赶集网招聘</website>   <job_name>搜索引擎 分词算法工程师</job_name>   <release_time>2012-10-08</release_time>   <description>职位描述：【招聘要求

17、】1、计算机或通信类相关专业，大专以上学历，有C/C+/Java应用开发经验；2、对搜索或中文分词算法有经验或有兴趣；或对Hadoop有了解；3、学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神；4、本公司有多个职位招聘，投递简历时请注明应聘职位。</description>   <email>zxtk_hr</email>   <comment />   <salary>面议</salary>   <view_num>0&

18、lt;/view_num>   <headcount>若干</headcount>   <comment_num>0</comment_num>   <pic_link>6/pic_link/zxtk-default.jpg</pic_link>   <http_link> </http_link>   <address>北京市海淀区中关村东路18号财智国际大厦C-1609</addres

19、s>   <telphone />   <company_introduction>公司简介：北京智信泰科科技有限公司是成立于北京中关村园区的高科技企业，专注于移动互联网的技术开发和服务。公司战略定位为：立足于移动信息市场，以3G发展为契机，以移动互联网为方向，以移动计算、移动存储、嵌入式开发、移动数据通信等技术为手段，为客户提供实用新颖的移动信息产品与服务。</company_introduction>   <longitude>123.391263</longitude>   <

20、latitude>41.808599</latitude>   <city />   <website_num>10</website_num>   <fids>4728 4735 4851 8580 9859 26448 26675 26799 32601 32788</fids>   <salary_range>3000.00 3000.00</salary_range>   <type>计算机/网络/通信招聘</type

21、>   <company>北京智信泰科科技有限公司</company> </product>对以上返回的XML数据格式的介绍：标签名称标签介绍Website招聘信息发布网站job_name职位名称release_time发布时间Description职位描述Email接收简历的email地址Comment评论Salary职位薪资view_num招聘信息的浏览次数Headcount招聘人数comment_num招聘信息的评论次数pic_link相关图片链接http_link发布网站的招聘信息链接Address公司地址Telepho

22、ne公司电话company_introduction公司介绍Longitude公司地址的经度Latitude公司地址的纬度City公司所在城市website_num发布同一职位的公司数量 或 同一公司在不同网站发布职位的总数Fids聚合内容的idsalary_range薪资区间Type招聘信息类别Company招聘公司的名称1.4调用方式3参数longitude(经度)、latitude（纬度）、和distance（范围）1.4.1获取职位数量接口1.4.2获取职位信息接口 &quantity=1.4.3 参数说明1）经度：参数名称longitude，float类型，含义精确的地理坐标

23、经度，如：123.382621；2）纬度：参数名称latitude，float类型，含义精确的地理坐标纬度，如：41.811932；3）范围：参数名称distance，double类型，含义是以上面的地址为中心搜索范围内的职位信息，以公里为单位，如果想查询500米、1公里或5公里范围内的职位，参数值对应为0.5、1或5；4）起始位置：参数名称start，int类型，含义是从数据的第n个位置开始获取数据，数据的起始位置为0；5）返回数量：参数名称quantity，int类型，含义是返回的数据数量，start和quantity参数共同使用可以完成翻页功能；1.4.4 接口举例搜索以经纬度为123.

24、382621，41.811932的位置，1公里范围内的职位；1）首先要确定职位的数量，以便在客户端实现分页显示功能；例如： latitude=41.811932&longitude=123.382621&distance=1 2）然后，再发送获取职位信息接口请求；编译后的接口例如： 注意：获取数量接口和信息接口的参数值必须 1.4.5 get_groupnum数量接口返回值1）正确返回数量值，如：100；表示根据发送的参数查询到的数据的数量；如果返回值为0的话，说明根据参数没有查询到相关数据；2）错误返回errorcode，表示地址参数输入错误，未查到此地址信息；1.4.6 r

25、esult视图返回XML数据格式实例 一条xml数据结构：-<product>  <website>赶集网招聘</website>   <job_name>搜索引擎 分词算法工程师</job_name>   <release_time>2012-10-08</release_time>   <description>职位描述：【招聘要求】1、计算机或通信类相关专业，大专以上学历，有C/C+/Java应用开发经验；2、对搜索或中文分词算法有经验或有

26、兴趣；或对Hadoop有了解；3、学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神；4、本公司有多个职位招聘，投递简历时请注明应聘职位。</description>   <email>zxtk_hr</email>   <comment />   <salary>面议</salary>   <view_num>0</view_num>   <headcount>若干</headcoun

27、t>   <comment_num>0</comment_num>   <pic_link>6/pic_link/zxtk-default.jpg</pic_link>   <http_link> </http_link>   <address>北京市海淀区中关村东路18号财智国际大厦C-1609</address>   <telphone />   <company_intro

28、duction>公司简介：北京智信泰科科技有限公司是成立于北京中关村园区的高科技企业，专注于移动互联网的技术开发和服务。公司战略定位为：立足于移动信息市场，以3G发展为契机，以移动互联网为方向，以移动计算、移动存储、嵌入式开发、移动数据通信等技术为手段，为客户提供实用新颖的移动信息产品与服务。</company_introduction>   <longitude>123.391263</longitude>   <latitude>41.808599</latitude>   <city /

29、>   <website_num>10</website_num>   <fids>4728 4735 4851 8580 9859 26448 26675 26799 32601 32788</fids>   <salary_range>3000.00 3000.00</salary_range>   <type>计算机/网络/通信招聘</type>   <company>北京智信泰科科技有限公司</company>

30、</product>对以上返回的XML数据格式的介绍：标签名称标签介绍Website招聘信息发布网站job_name职位名称release_time发布时间Description职位描述Email接收简历的email地址Comment评论Salary职位薪资view_num招聘信息的浏览次数Headcount招聘人数comment_num招聘信息的评论次数pic_link相关图片链接http_link发布网站的招聘信息链接Address公司地址Telephone公司电话company_introduction公司介绍Longitude公司地址的经度Latitude公司

31、地址的纬度City公司所在城市website_num发布同一职位的公司数量 或 同一公司在不同网站发布职位的总数Fids聚合内容的idsalary_range薪资区间Type招聘信息类别Company招聘公司的名称1.5调用方式3参数longitude(经度)、latitude（纬度）、keyword（关键字）和distance（范围）1.5.1获取职位数量接口1.5.2获取职位信息接口 &start=&quantity=1.5.3 参数说明1）经度：参数名称longitude，float类型，含义精确的地理坐标经度，如：123.382621；2）纬度：参数名称latitude

32、，float类型，含义精确的地理坐标纬度，如：41.811932；3）关键字：参数名称keyword，字符串类型，含义是与职位相关的职位名称或职位类型，需要进行utf-8编码；4）范围：参数名称distance，double类型，含义是以上面的地址为中心搜索范围内的职位信息，以公里为单位，如果想查询500米、1公里或5公里范围内的职位，参数值对应为0.5、1或5；5）起始位置：参数名称start，int类型，含义是从数据的第n个位置开始获取数据，数据的起始位置为0；6）返回数量：参数名称quantity，int类型，含义是返回的数据数量，start和quantity参数共同使用可以完成翻页功能

33、；1.5.4 接口举例搜索以经纬度为123.382621，41.811932的位置，1公里范围内的职位；1）首先要确定职位的数量，以便在客户端实现分页显示功能；例如： latitude=41.811932&longitude=123.382621&distance=1&keyword=销售 注意，中文要进行utf-8编码，编译后的接口为： 2）然后，再发送获取职位信息接口请求；编译后的接口例如： 注意：获取数量接口和信息接口的参数值必须1.5.5 get_groupnum数量接口返回值1）正确返回数量值，如：100；表示根据发送的参数查询到的数据的数量；如果返回值为0的

34、话，说明根据参数没有查询到相关数据；2）错误返回errorcode，表示地址参数输入错误，未查到此地址信息；1.5.6 result视图返回XML数据格式实例 一条xml数据结构：-<product>  <website>赶集网招聘</website>   <job_name>搜索引擎 分词算法工程师</job_name>   <release_time>2012-10-08</release_time>   <description>职位描述：

35、【招聘要求】1、计算机或通信类相关专业，大专以上学历，有C/C+/Java应用开发经验；2、对搜索或中文分词算法有经验或有兴趣；或对Hadoop有了解；3、学习能力强，踏实勤奋，有独立解决技术问题的能力，有高度的责任感，具有良好的沟通能力、团队合作精神；4、本公司有多个职位招聘，投递简历时请注明应聘职位。</description>   <email>zxtk_hr</email>   <comment />   <salary>面议</salary>   <view_num&

36、gt;0</view_num>   <headcount>若干</headcount>   <comment_num>0</comment_num>   <pic_link>6/pic_link/zxtk-default.jpg</pic_link>   <http_link> </http_link>   <address>北京市海淀区中关村东路18号财智国际大厦C-1609</a

37、ddress>   <telphone />   <company_introduction>公司简介：北京智信泰科科技有限公司是成立于北京中关村园区的高科技企业，专注于移动互联网的技术开发和服务。公司战略定位为：立足于移动信息市场，以3G发展为契机，以移动互联网为方向，以移动计算、移动存储、嵌入式开发、移动数据通信等技术为手段，为客户提供实用新颖的移动信息产品与服务。</company_introduction>   <longitude>123.391263</longitude>  

38、 <latitude>41.808599</latitude>   <city />   <website_num>10</website_num>   <fids>4728 4735 4851 8580 9859 26448 26675 26799 32601 32788</fids>   <salary_range>3000.00 3000.00</salary_range>   <type>计算机/网络/通信招聘<

39、/type>   <company>北京智信泰科科技有限公司</company> </product>对以上返回的XML数据格式的介绍：标签名称标签介绍Website招聘信息发布网站job_name职位名称release_time发布时间Description职位描述Email接收简历的email地址Comment评论Salary职位薪资view_num招聘信息的浏览次数Headcount招聘人数comment_num招聘信息的评论次数pic_link相关图片链接http_link发布网站的招聘信息链接Address公司地址Te

40、lephone公司电话company_introduction公司介绍Longitude公司地址的经度Latitude公司地址的纬度City公司所在城市website_num发布同一职位的公司数量 或 同一公司在不同网站发布职位的总数Fids聚合内容的idsalary_range薪资区间Type招聘信息类别Company招聘公司的名称1.6更多参数调用1.6.1获取职位数量接口首先，手机客户端发送查询请求到服务端会返回搜索到的招聘信息数量，比如：1000。上面URL列出的参数可以有一个或者多个，每个参数的含义见详细接口说明。1.6.2获取职位信息接口然后客户端第二次发送请求到两次发送的参数内容

41、应保持不变，第二次参数中需要多几个参数：start（起始位置），前面返回了职位数量，start为从第几个职位信息开始，默认为从1开始。quantity(每次返回信息数量)，默认为30条，信息以xml格式返回。1.6.3 所有调用接口举例下面列出几个测试url，开发者可以在浏览器中打开查看返回结果。 只有一个keyword参数，返回结果数量 条件中加了经纬度和距离参数，返回结果数量 条件中加了地址和距离参数，会将距离转为经纬度进行搜索 条件中没有加start和quantity参数，默认start为0，quantity为15 条件中加了start和quality参数，start为20，qualit

42、y为11.6.4 所有参数说明表URL中全部参数如下名称参数介绍参数举例sort_type排序方式-1为相关度，1，聚合度，2为薪资从低到高，3为薪资从高到低keyword关键字例如：销售origin来源例如：赶集网city城市例如：北京class分类例如：销售salary_min最低薪资例如：100salary_max最高薪资例如：200industry行业例如：医药，金融start起始位置例如：1quantity返回数量例如：30latitude纬度例如：41.811932longitude经度例如：123.382621distance距离（单位千米）例如：0.5或1或1.2address

43、地址例如：知春路、中关村黄色标注的为距离搜索时需要发送的参数，可以为（经度+纬度+距离）也可以为（地址+距离）。经纬度和地址为等价搜索条件，不能共存。1.5.6 result数据接口返回xml结构表格说明标签名称标签介绍Website招聘信息发布网站job_name职位名称release_time发布时间Description职位描述Email接收简历的email地址Comment评论Salary职位薪资view_num招聘信息的浏览次数Headcount招聘人数comment_num招聘信息的评论次数pic_link相关图片链接http_link发布网站的招聘信息链接Address公司地址T

44、elephone公司电话company_introduction公司介绍Longitude公司地址的经度Latitude公司地址的纬度City公司所在城市website_num发布同一职位的公司数量 或 同一公司在不同网站发布职位的总数Fids聚合内容的idsalary_range薪资区间Type招聘信息类别Company招聘公司的名称2 有聚合时根据fid获取对应招聘信息XML数据格式由于我们对相同公司的多个职位做了聚合，前面的XML接口是返回了聚合后的第一条招聘信息。在返回的信息栏位里有一个fid栏位，该栏位里包含了相同公司的其它招聘信息fid.如果我们想查看该公司其他招聘信息，将会用到下

45、面的接口。该接口只有一个参数fids,可以一次获取多个fid对应的招聘信息，多个fid中间用空格隔开，同样以XML格式返回。2.1接口举例 41362.2参数说明此接口只有一个参数fids，其中的值是对应result接口返回xml中Fids标签的数据，内容为<fids>283040 206083 205855 282062 282148</fids>，表示聚合数据的id值，将其值用空格拼接成字符串，就是参数fids的值，例如：fids=283040 206083 205855 282062 282148等等；2.3 content视图返回XML数据格式实例<?xm

46、l version="1.0" encoding="UTF-8" ?> - <products>- <product>  <website>大街网</website>   <job_name>手机软件销售代表</job_name>   <release_time>2012-10-08</release_time>   <description>职位描述：职位要求：1. 大专以上学历，有客户开发和服务经验

47、者优先；2. 勤于开拓创新、有责任心、有韧劲、工作积极主动；3. 熟练使用office办公软件，有良好的沟通和理解能力；4. 待遇优厚。</description>   <email>zxtk_hr</email>   <comment />   <salary>面议</salary>   <view_num>0</view_num>   <headcount>若干</headcount>   <comment

48、_num>0</comment_num>   <pic_link>6/pic_link/zxtk-default.jpg</pic_link>   <http_link>   <address />   <telphone>lt;/telphone>   <company_introduction>公司简介：</company_introduction>   <longitude>121.477905</longitude>   <latitude>31.207