HireHop é construído em cima de uma API, o que significa que qualquer coisa que você vê o HireHop fazer, você também pode realizar usando a API abrangente. Tudo o que você precisa para acessar a API Rest é um token de usuário aplicado como GET ou POST ao endpoint de URL relevante.
Tokens API
Para gerar um token de API, vá para a página “Configurações” e selecione a guia “Usuários”. Selecione ou crie um usuário e, enquanto esse usuário específico estiver selecionado, clique no botão “Menu” e na opção “Token de API” para gerar um token. O token será exibido e pode ser copiado para a área de transferência usando o botão de cópia.
O token se tornará inválido se você alterar o e-mail ou a senha do usuário selecionado ou, posteriormente, efetuar login nesse usuário. Para evitar que isso aconteça, você deve criar um usuário de API dedicado e, por segurança, dar a ele as permissões relevantes, restringindo-o de qualquer coisa para a qual não esteja usando a API.
Por motivos de segurança, você não deve usar o token no código JavaScript de front end, ele deve ser usado apenas no lado do servidor, pois se um hacker obtiver o token, ele pode alterar e acessar seus dados no HireHop, portanto, mantenha seu token em segredo. Se o seu token vazar, basta alterar a senha do usuário da API e gerar um novo token.
Usando um Token
Um token deve ser definido como um parâmetro GET ou POST que é chamado de “token”. Por exemplo, para carregar os dados do trabalho para o número 52, HireHop chamará o endpoint da API:
https://myhirehop.com/php_functions/job_refresh.php?job=52
Se você deseja chamar o mesmo endpoint usando um token, o URL seria:
https://myhirehop.com/php_functions/job_refresh.php?job=52&token=dqwejk5GVT65909bHHBN7922pq5hxjm%207hmn
Lembre-se de que, ao passar o token via GET (um parâmetro de URL como acima), você deve codificar o token primeiro usando uma ferramenta como https://meyerweb.com/eric/tools/dencoder.
Dados de Postagem
Para criar ou editar dados no HireHop, você deve usar um POST. Ao postar dados, você deve definir apenas os campos que deseja alterar, por exemplo, para criar ou editar um trabalho usando o endpoint https://myhirehop.com/php_functions/job_save.php, definindo o parâmetro “trabalho” para “0 “ou sua omissão criará um novo trabalho, qualquer outra coisa editará o número do trabalho relevante. Portanto, para editar o nome da empresa no trabalho número 52, os dados da postagem devem ser:
{
"job" : 52,
"name" : "New Name",
"token" : "dqwejk5GVT65909bHHBN7922pq5hxjm=-7hmn"
}
Pontos de extremidade da API
Muitos endpoints da API estão documentados na documentação da API, com muitos outros a seguir. Para estabelecer o terminal para uma tarefa, no aplicativo HireHop, use o console do navegador para inspecionar as chamadas de rede e quais parâmetros estão definidos. Um guia extenso para os endpoints de URL será publicado em breve.
Limites de taxa
O HireHop permite a cada usuário 60 solicitações de conexão em um período de 1 minuto. Se houver mais de 60, um erro “Aviso de segurança, muitas transações” (327) será retornado.