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.

You can have an unlimited number of custom fields in HireHop specific to each record, a record being a job, project, test/service, asset, etc.  All custom fields can be used in documents, as long as they exist, otherwise they will just be blank.

Currently custom fields are only fully supported in Jobs and Projects. Custom fields can only be used using plugins.

Custom Fields Structure

When fetching a custom field for the currently edited record, there is a function called _get_custom_field_value(field) which will return NULL if the field is not set, a string, or a JavaScript object, depending on how you saved it.

You probably should save custom fields as a JavaScript object (like JSON) in the following format for more printing control, as if it is just a string, HireHop will treat it as a string:

"field_name" :
{
"value"  : "The value of the field",
"type"   : "The field type, default is text, it can also be number, currency, text, date, html and array"
"format" : "For date type only, eg "ddd, dddddd tt" // = "Mon, January 1 2017 12:00"
}

• value is the value of the field in any format.
• type tells HireHop how the field should be treated when merging it into a document. An array field will be displayed as JSON.
• format tells HireHop how to format the field in the document, currently only available dates and is dependent on the users settings and how their date and time formats are set:
  • dddddd for a long date (like January 1 2018)
  • ddddd for a short date (like 01/01/2018)
  • dddd for the day of the week (like Monday)
  • ddd for the short day of the week (like Mon)
  • tt for the time (like 12:36 am).

The format part is only needed for dates and if it is not set, nothing will show.  You can merge formats together and add separators, for instance you can use dddd, dddddd tt which will give “Monday, January 1 2018 12:00” if the user has set a date order as day month year. The value for a date type must be stored in the yyyy-mm-dd hh:mm format.

If you just save the field as a string and not a JavaScript object, that’s fine, HireHop will just treat it as a string.  Saving your custom fields as a JavaScript object will give you greater control, especially when HireHop prints them in a document.

Saving The Custom Fields

On all edit forms that support custom fields, there is a function called _save_custom_field_value(field, value).  This stores your fields to be saved later.  If you can’t find the function, please contact us.

Please note, that all changes must be written prior to saving.

When the custom fields are saved, they are merged with the existing fields, and any new fields passed with the same name as any existing ones, the new values will be set.

When saving the custom fields, for example using /php_functions.job_save.php directly as an API call, only parameters set will be updated, so if you only set the custom_fields post parameter, only the custom fields will change, all the other fields will stay as is.

Printing Custom Fields

All custom fields can be incorporated into documents just like normal fields and are prefixed with a single “_” (underscore) character.  For example, for a custom field in a job called “field_name”, you would load it by using the merge field “job:_field_name“.

Naming Custom Fields

Some custom fields in documents merge fields together, for example tests merge with an asset in some document fields, so be careful not to use the same field name in an asset and a test.  Also, other plugins maybe added in the future written by yourself or from another source, so add a prefix that denominates you, for example plugins written HireHop by use the “hh_” prefix, so a field written in a plugin by us might be called “hh_NewName”.  Field names in document merges are not case sensitive, but they obviously are in JavaScript.

Searchable Custom Field

There is an additional field called CUSTOM_INDEX, that can be used for searching, filtering and listed in search results.  The field is a 45 character string value that can be set to NULL. To enable the field to be shown in the search results on the home page, change the allSearchCols global JavaScript variable by adding CUSTOM_INDEX to it:

if(allSearchCols.constructor===Array && doc_type==0 ) {
allSearchCols.push("CUSTOM_INDEX");
}

There is also a language setting for the custom field displayed name:

if(typeof(lang["customIndexTxt"])=="undefined" || lang["customIndexTxt"]=="") {
lang["customIndexTxt"] = "Custom field name";
}

The reason for the testing for undefined or blank above is just in case the user has set it in the language.

You can use the custom searchable field in the page by adding a lookup in the page or the editor.  On jobs there is a hidden tile that displays the  CUSTOM_INDEX field and can be shown and utilised like so in a plugin:

$("#job_tile_custom_index")
.show()
.click(function() {
window.open("https://www.my_external_app.com?id="+job_data["CUSTOM_INDEX"],"newwindow");
});

To save the CUSTOM_INDEX field in the relevant edit widget, using a custom plugin you can add a form element into the edit widget, for example like so:

// This adds the CUSTOM_INDEX field into the job edit widget
if(typeof($.custom.job_edit)!="undefined") {
// Redefine job_edit, move name to after telephone
$.widget("custom.job_edit", $.custom.job_edit, {
_init_main: function() {
// Call the old _init_main
this._super(arguments);
// Add an extra edit in the job edit
var table = this.default_disc.closest("table");
var tr = $("<tr>").appendTo( table);
$("<td>", { html: lang.customIndexTxt+ " :" }).appendTo(tr);
$("<input>", {
"name" : "custom_index", // Parameter to pass when saving
"class" : "data_cell",   // Setting class to data_cell tells HireHop it is a standard data field
"data-field" : "CUSTOM_INDEX", // Name of the field
"maxlength" : 45         // The CUSTOM_INDEX has a maximum length of 45 characters
})
.appendTo( $("<td>").appendTo(tr) );
// Change the memo height to compensate
this.job_edit_memo.height(110);
}
});
}

The CUSTOM_INDEX field is called xxx:custom_index in the document and is passed as a string into the document.

Global Custom Fields

Occasionally you might want to store a global counter, etc. for the whole company.  To read and store global custom fields use /php_functions/custom_fields_global_load.php and /php_functions/custom_fields_global_save.php.  Saving the data, you need to pass either a json string or json array:

$("#saving_dialog").dialog("open");
// This adds the CUSTOM_INDEX field into the job edit widget
$.ajax({
url: "/php_functions/custom_fields_global_save.php",
type: "post",
dataType: "json",
data: {
"fields":{"my_field":"any type of value"}
// or a json string
// "field":'{"my_field":"any type of value"}'
},
success: function(data)
{
$("#saving_dialog").dialog("close");
// HireHop reported an error
if(typeof(data.error) !== "undefined")
error_message(isNaN(parseInt(data.error)) ? data.error : lang.error[data.error]);
else
{
// All good, "data" is a javascript object (JSON) of all global custom fields
}
},
// Handle an http error
error: function(jqXHR, textStatus, errorThrown)
{
$("#saving_dialog").dialog("close");
error_message(lang.error[1]+" ("+errorThrown+").");
}
});