关于我们的自定义招聘服务的简短故事，以及与HeadHunter集成时在职位空缺方面出现的问题的大故事。 为什么选择HeadHunter？ 因为在Superjob上，一切都比较简单（但以后会更多）。
背景知识
我的团队正在为一个主要的零售链开发基于Web的工作安置应用程序。 行动链的构建方式如下：
- 企业批准所有商店和城市通用的基本空缺模板（要求，职责，条件）；
- 人力资源部根据基本模板为每个城市创建主要职位空缺模板，指示特定职位的薪资范围（不同地区的相同职位可能有不同的薪水）；
- 商店主管根据空缺模板在我们的应用程序内的他的商店中打开一个空缺并接收到该空缺的链接；
- 候选人通过链接进入问卷，在其中输入联系信息并将其发送给店长以供考虑；
- ??????
- 赢利！
当有人提议在HeadHunter上发布职位空缺并链接到调查表时，我简短地研究了他们的API的文档，并想到了“有5分钟的生意”的风格。 现在，大约1.5个月后，我正在写这篇文章。
使用HeadHunter API
因此，需要在HeadHunter上发布职位空缺，您将需要：
当前的API版本
不幸的是（或幸运的是？），该API未进行版本控制，因此， 理论上讲 ，任何时候都可能会掉线。 即使从未发生过，并且没有任何先决条件，它仍会更新：
您可以在文档中未描述的答案和API参数中找到键。 通常，这意味着保留它们是为了与旧版本兼容。 不建议使用它们。
申请注册
这里的一切都很简单，但没有我们想要的那么简单。 您将被要求填写一个表格，其中一个字段包含以下文字：“ 描述应用程序的所有功能并指出使用的API方法 。” 如何详细???
首次注册时，会详细填写表格，指明所有路线，第二次仅对短语“ 来自空缺区的所有方法 ”有足够的耐心。 两个选项都通过了。
申请被批准大约两个星期。 这是我们的整合拖延了一点的原因之一。
注册第二份申请
注册应用程序时，请注意Redirect URI参数。 根据我们的观察，由HeadHunter技术支持确认，如果您的测试电路位于子域（例如test.example.com）上，那么您需要销售（带有redirect_uri = example.com）和开发（带有redirect_uri = test.example.com）的应用程序） 这是另外两个星期的等待批准。
学习并阐明规则
当我们在测试模式下开发功能并发布封闭的空缺时，一切都很好。 将开放的空缺下载到出版物中后，发现链接由于空缺放置规则的禁止而消失了，但是，根据支持的话，可以自动将链接发送给用户作为响应（规则中未对此进行描述）。 在这里，我们由于自己的粗心大意而感到失望，但是，我认为，可以将验证器置于接收空缺文本的阶段。
有点直觉
有时错误文本是完全无法预测且不合逻辑的。 这是我们面临的问题：
not_enough_purchased_services （用于发布或更新这种类型的空缺的购买服务是不够的）-发布类型为free的空缺时。 免费职位究竟需要购买什么尚不清楚。 解决方案：指定type: standard ；quota_exceeded （发布此类空缺的经理配额已结束）-经理配额是通过https://hh.ru/employer/settings/quotas配置的，这是我们上次在type字段中输入standart而不是standard时看到的；- 使用
ignore_duplicates标志时出现duplicate （已经发布了类似的空缺）-当name和area字段相同时，无论是否存在忽略重复项的标志，都会发生重复项。
也一样
关于安全
考虑到令牌的寿命为两周（显然，这是他们最喜欢的时间），并且您不能仅通过razlogin提前刷新令牌。 从理论上讲，这应该不会造成问题，但是，如果令牌泄漏，则攻击者可能有足够的时间进行反射，暴行和幸灾乐祸。
关于界面
职位描述是单个description字段，它支持多个HTML标记，但是格式化仅在通过网站发布时有效。 通过API发送的HTML变成纯文本。
关于参考书
像整个API一样，目录可以随时更改，如其描述中明确指出的那样：
错误也可能发生，例如，在发现多余空间的区域目录中，您可能尚未准备好。 我开始对此主题进行审查 ，希望他们能够解决该问题，但要小心。
总结
快速入门大约需要两个星期，可能需要注册几个应用程序。 总的来说，文档和API本身都很理智，否则您可以弄清楚如何与技术支持进行通信，或者通过github上的问题进行交流。
我敢肯定，我们没有找到与HeadHunter API相关的所有有趣信息，因为我们甚至都没有触摸过简历分支。 因此，如果您有话要告诉/补充/说明，请在评论中写。
聚苯乙烯
超级作业API和与HeadHunter的一些比较：habr.com/zh/post/465663