百伯开放数据接口文档平台篇v18 beta1.docx
《百伯开放数据接口文档平台篇v18 beta1.docx》由会员分享，可在线阅读，更多相关《百伯开放数据接口文档平台篇v18 beta1.docx（13页珍藏版）》请在冰豆网上搜索。
百伯开放数据接口文档平台篇v18beta1
百伯开放数据接口文档--平台篇
（版本1.8）
上海XX人才咨询有限公司
修订历史
日期
版本号
修订说明
修订人
审批人
2012-03-29
1.0
创建初始版本
张培进
2012-06-28
1.1
修改接口为接入平台对外提供接口
韩卫召
2012-8-13
1.2
增加删除接口格式
韩卫召
2012-9-03
1.3
张俊
2012-10-30
1.4
张俊
2012-11-12
1.5
增加招聘会规格信息
张俊
2012-11-14
1.8
修改招聘会开始时间
张俊
2012-11-21
1.9
增加公司简介等信息
张俊
1.文档说明
1.1文档目标
本文档目的是为百伯开放平台定义一个接口规范，以帮助第三方招聘网站开发人员接入百伯开放平台，引导其快速掌握百伯开放平台的使用。
1.2阅读对象
百伯开放平台企业应用的开发人员，维护人员，管理人员；
他们应该具备以下能力：
1、了解基础的网站设置与网页制作的方法。
2、了解HTML语言以及ASP或者JSP、PHP等开发语言。
3、了解信息安全相关概念。
1.3相关约定
下列术语、定义和缩略语适用于本标准：
词语
解释
HTTP
HyperTextTransferProtocol
URL
UniformResourceLocators
XML
JSON
ExtensibleMark-upLanguage
JavaScriptObjectNotation
1.4技术支持
在开发或使用过程时有任何疑问可通过以下方式获取技术支持：
技术支持邮箱：
support@
时间：
周一至周五（法定节假日除外）9：
00~18：
00
2接入前提
第三方招聘平台接入百伯开放数据平台，需要先进入百伯开放数据平台进行完成注册或者向百伯pm进行邮件申请，审核通过后才具备接入条件。
3接口开发
3.1.1第三方平台发布职位流程介绍
为增强资源共享，共享“百伯网”每天400万访客的优势资源，“百伯网”向其他招聘平台开放信息对接接口。
详细流程如下：
1、第三方平台使用自己的招聘网站上发布招聘的职位、资讯、招聘会信息；
2、按照百伯定义的接口格式对外开放接口;
3、百伯定时抓取职位信息，索引，对外提供搜索服务;
3.1.2第三方平台--------职位发布接口
3.1.2.1索引文件
示例：
此地址需要提交给百伯。
sitemap.xml格式：
xmlversion="1.0"encoding="utf-8"?
>
—资源文件地址 -->
—最后更改时间 -->
2010-04-26
2010-04-26
3.1.2.2资源文件url1.xml
xml version="1.0" encoding="UTF-8"?
>
-- 必有；urlset用来标记整个文档的开头；注意：
以下各字段，必须按给定的顺序组织 -->
-- 必有；url标记每条信息的开始和结束 -->
[CDATA[ ]]>
-- 必填；描述职位详细信息页面URL地址，首尾勿带空格、不可见的换行符号,字段最大长度为256个字符 -->
2010-11-20
-- 必填；用来指定该链接的最后更新时间，时间格式：
yyyy-mm-dd -->
always
-- 可以不提交该标签；用这个标签告诉此链接可能会出现的更新频率，有效值为:
always， hourly，daily，weekly，mothly，yearly，never -->
1.0
-- 可以不提交该标签；用来指定此链接相对于其他链接的优先权比值，此值定于0.0-1.0之间 -->
-- 职位数据内容 -->
[CDATA[
-- （可选字段，可不填。
填写后，手机上会展现wap页面，效果更好）：
与loc对应的wap资源页URL -->
<!</p><p>[CDATA[ HPSW-Senior R&D Manager-Shanghai]]>
-- 必填；职位名称，一般情况下只需填写职位名称即可，不可包含网站地址 ,字段最大长度为80个字符-->
2011-01-17
-- 职位信息发布的结束日期
日期格式：
yyyy-mm-dd （如果不清楚，请填职位信息截止日期）-->
[CDATA[ HP is a leading global provider of products, technologies, solutions and services to consumers and business. ]]>
-- 必有；职位描述，内容可以为空，
内容为普通文本。
文本内可以换行，但不得包含字体，字号，间距等格式定义标签，文本中禁止使用script脚本以及超链接,字段最大长度为100000个字符 -->
社会招聘
-- 必有；工作性质（社会招聘、实习、兼职、校招等）,字段最大长度为20个字符 -->
上海
-- 必填；工作地点
正确格式如“湖南省-长沙市”、“上海市”、“上海闸北”、“上海闸北区”
只能填写一个城市名称
不建议直接填写区名,字段最大长度为50个字符 -->
[CDATA[ 惠普公司]]>
-- 必填；公司名称,字段最大长度为150个字符 -->
test@
-- 必有；公司联系Email,字段最大长度为100个字符 -->
[CDATA[ 计算机软、硬件/互联网/IT]]>
-- 必有；职位大类，如“销售” ,字段最大长度为100个字符-->
[CDATA[ 高级软件工程师]]>
-- 必有；职位小类，如“销售代表”，“电话销售” ,字段最大长度为100个字符-->
本科
-- 必填；学历要求，如“大专”，“本科”等。
若无要求请填写“不限”
不得为空。
字段最大长度为20个字符 -->
5年以上
-- 必填；工作经验要求；如“3-5年”，“2年以上”。
若无要求请填写“不限”
不得为空。
,字段最大长度为20个字符-->
2010-04-05
-- 必填；职位信息发布日期，必须与页面上的日期保持一致。
日期格式：
yyyy-mm-dd -->
2011-01-17
-- 必填；职位信息截止日期。
日期格式：
yyyy-mm-dd -->
面议
-- 必填；薪资要求，可为以下3种格式
1）“面议”
2）“aaaa-bbbb元”
3）“aaaa元”
不得为空 ,字段最大长度为20个字符-->
[CDATA[ IT服务（系统/数据/维护）/多领域经营,计算机硬件及网络设备]]>
-- 必有；公司所属行业。
如“IT”，“金融”等,字段最大长度为180个字符 -->
合资
-- 必有；公司性质。
如“国企”，“私企”等 ,字段最大长度为40个字符-->
百伯
-- 必填；网站名称，如“百伯” ,字段最大长度为40个字符-->
[CDATA[
-- 必填；网站url，与source相对应，如“” ,字段最大长度为500个字符-->
北京市朝阳区三里屯sohoE坐XX层
-- 必填；招聘公司工作详细地址,字段最大长度为256个字符-->
1000
-- 必填；招聘人数,字段最大长度为20个字符-->
百伯成立于2011年1月，是XX旗下独立运营子公司。
百伯原名为XX人才，2011年9月22日正式更名为百伯......
-- 必填；公司简介,内容可以为空，
内容为普通文本。
文本内可以换行，但不得包含字体，字号，间距等
格式定义标签，文本中禁止使用script脚本以及超链接。
字段最大长度为100000个字符-->
北京市朝阳区三里屯sohoE坐XX层
-- 必填；招聘公司公司详细地址,字段最大长度为256个字符-->
刘先生
-- 选填；招聘公司联系人姓名,字段最大长度为50个字符-->
1528888888,010-8888888-899
-- 选填；招聘公司联系电话,字段最大长度为50个字符-->
地铁十号线长虹桥西乘公交416三里屯站下
-- 选填；招聘公司乘车路线,字段最大长度为150个字符-->
2012-12-21到2012-12-23阴天有雨，自备雨伞
-- 选填；温馨提示,字段最大长度为100个字符-->
-- 必有；display字段为固定格式 -->
3.1.2.3删除职位接口文件del1.xml
提示：
索引文件格式同添加职位接口一致
xmlversion="1.0"encoding="utf-8"?
>
--需要和添加接口职位地址一致-->
[CDATA[
--需要和添加接口职位地址一致-->
[CDATA[
3.1.3第三方平台------招聘会接口
3.1.3.1招聘会索引文件
示例：
此地址需要提交给百伯。
sitemap.xml格式：
xmlversion="1.0"encoding="utf-8"?
>
—资源文件地址 -->
—最后更改时间 -->
2010-04-26
2010-04-26
3.1.3.2招聘会资源文件url1.xml
xml version="1.0" encoding="UTF-8"?
>
-- 必有；urlset用来标记整个文档的开头；注意：
以下各字段，必须按给定的顺序组织 -->
-- 必有；url标记每条信息的开始和结束 -->
[CDATA[ ]]>
-- 必填；描述招聘会详细信息页面URL地址，首尾勿带空格、不可见的换行符号 ,字段最大长度为256个字符-->
2010-11-20
-- 必填；用来指定该数据最后更新的时间，时间格式：
yyyy-mm-dd -->
always
-- 可以不提交该标签；用这个标签告诉此链接可能会出现的更新频率，有效值为:
always， hourly，daily，weekly，mothly，yearly，never -->
1.0
-- 可以不提交该标签；用来指定此链接相对于其他链接的优先权比值，此值定于0.0-1.0之间 -->
-- 招聘会数据内容 -->
<!</p><p>[CDATA[ 省城济南史上最大规模人才招聘会]]>
-- 必填；招聘会名称，一般情况下只需填写招聘会名称即可，不可包含网站地址 ,字段最大长度为80个字符-->
2010-04-05
-- 必填；招聘会开始日期，日期格式：
yyyy-mm-dd -->
2011-01-17
-- 必填；招聘会信息截止日期。
日期格式：
yyyy-mm-dd -->
济南
-- 必填；招聘会主办省市
正确格式如“上海”、“上海市”、“上海闸北”、“上海闸北区”
只能填写一个城市名称
不建议直接填写区名 ,字段最大长度为20个字符-->
山东省科技馆（泉城广场东邻）
-- 必填；招聘会主办详细地址
不得为空,字段最大长度为150个字符 -->
百伯
-- 必填；你的网站名称，如“百伯” ,字段最大长度为30个字符-->
[CDATA[
-- 必填；你的网站url，与source相对应，如“” ,字段最大长度为500个字符-->
-- 必有；display字段为固定格式 -->
3.1.4第三方平台------招聘资讯接口
3.1.4.1招聘资讯索引文件
示例：
此地址需要提交给百伯。
sitemap.xml格式：
xmlversion="1.0"encoding="utf-8"?
>
—资源文件地址 -->
—最后更改时间 -->
2010-04-26
2010-04-26
3.1.4.2招聘资讯资源文件url1.xml
xml version="1.0" encoding="UTF-8"?
>
-- 必有；urlset用来标记整个文档的开头；注意：
以下各字段，必须按给定的顺序组织 -->
-- 必有；url标记每条信息的开始和结束 -->
[CDATA[ ]]>
-- 必填；描述招聘资讯详细信息页面URL地址，首尾勿带空格、不可见的换行符号 ,字段最大长度为256个字符-->
2010-11-20
-- 必填；用来指定该数据最后更新的时间，时间格式：
yyyy-mm-dd -->
always
-- 可以不提交该标签；用这个标签告诉此链接可能会出现的更新频率，有效值为:
always， hourly，daily，weekly，mothly，yearly，never -->
1.0
-- 可以不提交该标签；用来指定此链接相对于其他链接的优先权比值，此值定于0.0-1.0之间 -->
-- 招聘资讯数据内容 -->
<!</p><p>[CDATA[ 简历制作引导]]>
-- 必填；招聘资讯标题，一般情况下只需填写招聘资讯标题即可，不可包含网站地址 ,字段最大长度为80个字符-->
2010-04-05
-- 必填；招聘资讯发布日期，日期格式：
yyyy-mm-dd -->
2011-01-17
-- 必填；招聘资讯截止日期。
日期格式：
yyyy-mm-dd -->
[CDATA[ 资讯内容]]>
-- 必填；招聘资讯内容 ,字段最大长度为100000个字符-->
true
—必填；是否包含图片，必须为true或者false -->
面试攻略
—必填；招聘资讯分类只能是如下分类；简历技巧、面试攻略、职业规划、人力资源、薪酬福利、绩效管理、大话职场每条信息只能属于一个分类 -->
百伯
-- 必填；你的网站名称，如“百伯” ,字段最大长度为30个字符-->
[CDATA[http:
//www.
-- 必填；你的网站url，与source相对应，如“” ,字段最大长度为500个字符-->
-- 必有；display字段为固定格式 -->
3.2开发提示
删除职位接口，索引文件格式同添加职位接口一致。
3.3完全要点
4常见问题
4.1xml在格式方面是否有通用规范？
支持的编码格式为UTF-8和gbk，推荐使用utf-8编码。
注意：
XML文件头部的encoding值必须与XML文件的实际编码类型一致。
另外，建议最好使用gzip压缩文件，否则不要压缩。
4.2我的招聘页的数据量很大，提交时需要注意什么？
每个资源文件最多可包含50000个url，并且文件在压缩前不得超过10MB（10,485,760字节，文件具体包含职位数量根据职位信息内容大小而定，只要资源文件不超过10MB就可以）为了避免资源浪费请去掉所有没必要的xml注释信息.
如果超过10MB，必须将其分割成多个文本文件，并提供索引文件，索引文件格式如下：
xmlversion="1.0"encoding="utf-8"?
>
url1.xml
2010-04-26
http:
//www.
2010-04-26
4.3数据提交后多久能上线？
通过PM审核后，即可即时上线。
4.4招聘中间页中的职位信息排序策略如何?
主要是按检索结果相关性进行排序，具体说来：
XX会将用户的检索词和商户提交数据中的标题、tags等进行匹配，符合用户所查商品分类、属性和品牌的商品具有更高的相关性。
4.5如果新增、删除招聘信息，如何更新？
新增数据，在xml文件中按照设置的周期更新即可。
删除数据，把删除的数据按照3.1.2.3格式组织数据提交即可。
提交删除地址会保证您站点的搜索质量，提高站点权重。
5附录
5.1版权说明
此文档的版权归上海XX人才咨询有限公司所有，作为本系统的最终用户，可以拥有该文档的使用权，但未征得上海XX人才咨询有限公司的书面批准，不得修改，公布本文档，不得向第三方出让、出版本文档。
**********************************************************
如果您对本文档及百伯有任何建议或意见，请发送邮件至support@。
百伯衷心感谢您的支持！
升级会员 