Aquí puedes encontrar algunos ejemplos de cómo empezar rápidamente a utilizar la API desde Curl y Java.
› Obtener el punto de anclaje principal
curl -i -X GET 'https://dev.hrider.net/api/v1' -H 'authorization: yourAuthAPIKey'
› Obtener todas las compañías de la cuenta.
curl -i -X GET 'https://dev.hrider.net/api/v1/companies' -H 'authorization: yourAuthAPIKey'
› Obtener los datos de la compañía con ID 12345
curl -i -X GET 'https://dev.hrider.net/api/v1/companies/12345' -H 'authorization: yourAuthAPIKey'
› Crear una nueva compañía
curl -i -X POST 'https://dev.hrider.net/api/v1/companies' \
-H "Content-Type: application/json" \
-H 'authorization: yourAuthAPIKey' \
--data-binary @companyData.json
El fichero companyData.json contiene los datos de la compañía a crear. Por ejemplo:
{
"name":"NEMO",
"limit":100,
"address":"Atlantic Sea 17",
"taxIdNumber":"B12345678",
"language":"en"
}
› Obtener la lista de empleados de la compañía con ID 12345, de 20 en 20 empleados por página
curl -i -X GET 'https://dev.hrider.net/api/v1/companies/12345/employees?pageSize=20' \
-H 'authorization: yourAuthAPIKey'
› Asignar a un administrador dos compañías con IDs 123 y 456
curl -L -i -k -X PUT 'https://localhost:9191/api/api/v1/administrators/6562/companies' \
-H 'Content-Type: text/uri-list' \
--data-binary '@companies.uris' \
-H 'authorization: bearer oC0aGOzvwLSHJaDQ5kJv2bavrtmjkkYRAnb8BVoN'
El fichero
companies.uris es un fichero de texto con
content type
text/uri-list, que incluye una URI por línea
con cada una de las compañías que queremos asignar al administrador:
https://dev.hrider.net/api/v1/companies/123
https://dev.hrider.net/api/v1/companies/456
Si se desea, el sistema también acepta URIs abreviadas del tipo:
/companies/123
/companies/456
› Crear un empleado
curl -i -X POST 'https://dev.hrider.net/api/v1/employees' \
-H "Content-Type: application/json" \
-H 'authorization: yourAuthAPIKey' \
--data-binary @employeeData.json
El fichero employeeData.json contiene los datos del empleado a crear. Por ejemplo:
{
"address": "47 W 17TH ST, NEW YORK",
"birthDate": "1990-02-17T00:00Z",
"city": "NEW YORK",
"code": "EMP001",
"country": "USA",
"email": "[email protected]",
"externalId": "123",
"firstName": "JOHN",
"gender": "male",
"hireDate": "2014-07-27T00:00Z",
"lastName": "OWEN",
"nationalId": "11111111R"
}
› Establecer la foto de un empleado
curl -i -X POST 'https://dev.hrider.net/api/v1/companies/12345/employees/1234/photo' \
-H 'authorization: bearer oC0aGOzvwLSHJaDQ5kJv2bavrtmjkkYRAnb8BVoN' \
-F 'data=@./files/photo.png' /dev/stdout
› Obtener un empleado
curl -i -X GET 'https://dev.hrider.net/api/v1/companies/12345/employees/1234' \
-H 'authorization: yourAuthAPIKey'
› Asignar un puesto al empleado. Suponiendo que
el ID del puesto es 567 y el del empleado 1234
curl -i -X PUT 'https://dev.hrider.net/api/v1/companies/12345/employees/1234/position' \
-H 'authorization: yourAuthAPIKey' \
-d 'https://dev.hrider.net/api/v1/companies/12345/departments/777/positions/567'
› Asignar subordinados a un empleado. Suponiendo que los subordinados tienen IDs 1111 y 2222
curl -i -X PUT 'https://dev.hrider.net/api/v1/companies/12345/employees/1234/subordinates' \
-H 'authorization: yourAuthAPIKey' \
--data-binary @subordinatesData.txt
El fichero subordinatesData.json contiene las URIs de los empleados a establecer
como subordinados:
https://dev.hrider.net/api/v1/companies/12345/employes/1111
https://dev.hrider.net/api/v1/companies/12345/employes/2222
