Perguntas frequentes sobre a API Superjob (publicação de emprego)

Recentemente, falei sobre a API do Headhunter para postar trabalhos, mencionando o Superjob. Agora, tendo implementado a mesma funcionalidade na API do Superjob, será justo compartilhar sua experiência com você.


imagem


Trabalhando com a API Superjob


Portanto, há a tarefa de publicar vagas no Superjob, você precisará:


Versão atual da API


Tudo é esperado aqui - o versionamento está presente e passado no URL:


https://api.superjob.ru/:version/method_name/:params 

Registro do aplicativo


Além disso, o procedimento mais simples é criar uma conta, criar um aplicativo, obter tokens. Sem expectativas registro e SMS .


redirect_uri , transmitido nos parâmetros, aparentemente, não está associado ao URL de retorno especificado nas configurações do aplicativo. Não é possível especificar (URL de retorno de chamada), tudo funcionará.


Tambem


Especifique os parâmetros necessários


Responsabilidades, requisitos e condições são parâmetros opcionais da vaga, mas o nome da empresa e uma descrição de suas atividades devem ser transferidos para cada vaga.


Na última vez (no HeadHunter), houve uma tentativa de publicar o link dentro da vaga, aqui o parâmetro url foi encontrado, no entanto, não foi possível entender onde ele aparece na vaga.


Solicitar um link para uma vaga criada


Em vez do super-emprego / vagas / id esperado, o link é formado na forma de vacancy-name-id.html, mas apenas o ID da vaga vem na resposta. O texto em russo é transliterado por um algoritmo desconhecido (ou de acordo com um dos N GOSTs), o que torna impossível formar um link do seu lado. Você deve fazer uma solicitação separada para a rota da API de onde o link completo já foi retornado.


Escolha entre horário de trabalho e tipo de emprego


O Superjob combina esses dois campos, oferecendo na lista, por exemplo, meio período ou meio período. Isso é inconveniente quando há temporizadores de parte, contratos a prazo e outros cenários.




Sumário


Sobre formatação e tarefas sem análise


Na última vez, mencionei que as vagas no HeadHunter suportam HTML e um editor WYSIWYG está ferrado no site por isso. Além da tarefa de publicar links nas vagas (que falharam um pouco), também chegou a tarefa de fixar o WYSIWYG para eles em nosso aplicativo. O texto da vaga, juntamente com a formatação, é salvo no banco de dados, da mesma forma que foi para o Superjob, que o HTML não suporta. Em princípio, é esperado, mas o principal fakap é que, depois de analisar a mesma vaga no HeadHunter, descobriu-se que ele também não suporta a formatação enviada! As tags são simplesmente excluídas e o texto simples permanece na saída. Como resultado, o WYSIWYG será cortado e todas as vagas gravadas com HTML precisarão ser analisadas e limpas em três bancos de dados de alguma forma.


Eu gostaria de escrever muitos palavrões sobre terceirização, mas em outro momento.


Sobre conveniência


Se compararmos o HeadHunter e o Superjob, é óbvio que, com o último, tudo é muito mais simples. A integração foi criada muito rapidamente - os textos de erro não eram confusos, tudo foi testado em vários ambientes devido ao URL de retorno de chamada opcional.


O que me chateou foi a falta de uma API Superjob no Github, mas lá me diverti com um "cliente simples" em PHP por mil e quinhentas linhas. Há um feedback para se comunicar com o suporte técnico, no entanto, na forma de um recurso, não há categoria de perguntas por parte da API. Bem, isso.


Conclusão


Em geral, dificilmente se pode dizer inequivocamente que alguém é melhor, alguém é pior. O Superjob tem algo a reclamar, mas no final, o serviço fornece uma API normal que resolve completamente nossos problemas.

Source: https://habr.com/ru/post/pt465663/


All Articles