Discussions

Ask a Question

Access API as an employee

Is there no way to access this API as an emply of an organization? I was interested in having a way to get and display the shifts of myself and my roommates, but It doesn't seem that it's possible.
ANSWERED

Retrieve information on Grouped Accounts via API

Hi! In our institution we have a main parent account and several grouped accounts. When I use the API I can only retrive information (locations, employees, shifts, etc) from my main account, but no from the children accounts. I can list grouped accounts vía **group.accounts**, but not location, employees, etc from children accounts. There is a way to achieve that? Thank you!

Issue with the staff.login module

Hi there, I can't seem to get a successful response even after using the right credentials, and I keep getting the following error message: {"status":98,"data":"Bad API Paramaters - Invalid POST request. See Manual.","error":"no post `data`","token":null} I send a POST request to the following URL https://www.humanity.com/api/ with the following data: { "module":"staff.login", "method":"GET", "request":{ "key":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "username":"[email protected]", "password":"xxxxxxxxxx" } } Is there something I'm doing wrong?

User required?

Hi, we want to display a list of staff currently working on a kind of dashboard. It works perfectly, but do I really authorize as a user? First, this feels wrong because the dashboard is "public" and belongs to no specific user. I would need to hard code username / password because the dashboard runs on a TV screen. Second, creating a "API-User" is currently the same as creating new employee. So the API-User would cost the same licence as a regular employee. Using just "some" user's credentials is no option for me, because this is even more bad practise. It would really be great if such general, not user-specific information would be available with only App ID / App Secret. I would really love to use the API, but Thank you, best regards Sebastian Becker

How to update ONLY ClockOut of particular employee.

There is Employee ClockIn/ClockOut api's for entering the InTime and OutTime details. clockin - https://www.humanity.com/api/v2/employees/id/clockin clockout - https://www.humanity.com/api/v2/employees/123/clockout?access_token=xxxxxxx assume that the employee "abc" has already ClockIn and ClockOut in the scheduler, so now if i want to update only "ClockOut" then which API i need to use.
ANSWERED

Getting more specific data:

Hey there. The specific things i'm trying to access are 1. staff list 2. if each of those staff members is currently working or not. Or is there any way to access this info via the API? Thanks.

Generating API keys that last longer than 2 weeks

Hey team, I wonder if you can help advise on how we can generate an API key that lasts longer than 2 weeks?. We currently have our Humanity app integrated with our Salesforce app but unfortunately, I can't find any way to generate an API key that lasts longer than 2 weeks meaning our integration breaks every two weeks. I did check the documentation but perhaps I'm missing something. Looking forward to hearing from someone

Filters for Get-Shifts API

Hey We were looking at the Get-Shifts API - https://platform.humanity.com/reference#get-shifts and we were trying to understand if we could filter the shifts using some filter like on start_date or end_date or a date range between these two. Our use case is to filter all the employees in the shifts which are currently going on, and figure out from one of our internal APIs if those users are online or not. Can you suggest a way to help us filter the employees who are having an active shift currently ?

Where do I find my client id and secret?

All I have is something my product owner gave me and called a "key". I don't know how to find the client id and client secret.

how to get only published shifts ?

Is it possible to filter between published and unpublished shifts in schedules.shifts get call?