Přeskočit na obsah
Čeština
Kontaktovat podporu
Přihlásit se
  • K dispozici nejsou žádné návrhy, protože pole hledání je prázdné.

Synchronizace zaměstnanců přes API

Synchronizace zaměstnanců přes API vám umožní synchronizovat seznam zaměstnanců vaší instituce s platformou FaceUp.

Udržování aktuálních údajů o zaměstnancích je klíčové pro efektivní správu podnětů, vyšetřování a compliance procesy. Synchronizace zaměstnanců přes API umožňuje organizacím automaticky synchronizovat seznam zaměstnanců z externího systému do FaceUp, což zajišťuje, že práce s podněty a vyšetřování vždy odráží aktuální organizační strukturu.

Zatímco FaceUp nabízí nativní integrace, které umožňují propojení údajů o zaměstnancích jen na pár kliknutí (viz naše nativní integrace zde: https://www.faceup.com/cs/integrace), synchronizace zaměstnanců přes API představuje flexibilní alternativu pro propojení systémů, které zatím nativně nepodporujeme, včetně Workday, ADP, SAP a Oracle.

Pro HR, compliance a etické týmy synchronizace zaměstnanců pomáhá zajistit, že:

  • Podněty a vyšetřování jsou propojeny se správnými osobami, ať už je zaměstnanec oznamovatelem, osobou, které se oznámení týká, nebo svědkem

  • Podněty jsou řešeny ve správném organizačním kontextu, včetně oddělení, týmů a konkrétních osob v rámci organizace

  • Administrátoři mohou zobrazovat podněty přiřazené ke konkrétním zaměstnancům a snadněji identifikovat trendy nebo opakující se problémy v týmu či oddělení

  • Ruční zadávání a nesrovnalosti v datech jsou minimalizovány, zejména ve větších nebo rychle se měnících organizacích

Automatizací synchronizace zaměstnanců mohou organizace udržovat spolehlivé a pro audit připravené prostředí pro oznamování bez nutnosti manuálních aktualizací nebo používání tabulek. To je obzvláště přínosné pro rostoucí společnosti a enterprise prostředí, kde se údaje o zaměstnancích často mění.

Následující část vysvětluje, jak implementovat synchronizaci zaměstnanců pomocí FaceUp API.

Předpoklady

Pro komunikaci s FaceUp API je nutné znát API klíč vaší instituce a region hostování dat. Tyto informace najdete v souvisejícím článku.

Endpoint

URL: https://www.api.faceup.com/graphql

Metoda: POST

Povinné headers

Header Popis Příklad
Authorization Váš API klíč fui_abc123...
Content-Type Musí být application/json application/json
X-Region Region hostování dat eu-west-1, us-east-1, ...

GraphQL mutace

mutation SyncEmployees($input: SyncEmployeesInput!) {
syncEmployees(input: $input) {
success
}
}

Typy inputů

input SyncEmployeesInput {
employees: [EmployeeAttributesInput!]!
}

input EmployeeAttributesInput {
name: String!
email: Email!
status: EmployeeStatus!
location: String
department: String
jobTitle: String
supervisor: String
}

enum EmployeeStatus {
Active
Inactive
}

Pole zaměstnance

Pole Typ Povinné Max. délka Popis
name String Ano 255 Celé jméno zaměstnance
email Email Ano - E-mail zaměstnance (slouží jako unikátní identifikátor)
status Enum Ano - Active nebo Inactive
location String Ne 255 Místo pracoviště nebo město
department String Ne 255 Název oddělení
jobTitle String Ne 255 Pracovní pozice
supervisor String Ne 255 Jméno nadřízeného zaměstnance

Chování

Synchronizace funguje na principu all-or-nothing:
  • Úspěch: Pokud všichni zaměstnanci projdou validací, synchronizuje se celá várka a vrátí se success: true 
  • Chyba: Pokud alespoň jeden zaměstnanec validací neprojde, nesynchronizuje se nikdo a vrátí se errors 
Operace používá logiku upsert (update nebo insert) na základě e-mailové adresy:
  • Nový zaměstnanec: Pokud zaměstnanec s daným e-mailem neexistuje, vytvoří se nový záznam
  • Existující zaměstnanec: Pokud zaměstnanec s daným e-mailem již existuje, jeho údaje se aktualizují
  • Zaměstnanci, kteří nejsou součástí požadavku, zůstávají beze změny

Limity a rate limity

  • Rate limit: 10 požadavků za sekundu
  • Maximální počet zaměstnanců v jednom požadavku: 1 000

Pokud potřebujete synchronizovat více než 1 000 zaměstnanců, rozdělte je do více požadavků.

Příklad cURL požadavku

curl -X POST https://www.api.faceup.com/graphql \
-H "Content-Type: application/json" \
-H"Authorization: fui_your-api-key-here"\
-H "X-Region: your-region-here" \
-d'{
"query": "mutation SyncEmployees($input: SyncEmployeesInput!) { syncEmployees(input: $input) { success } }",
"variables": {
"input": {
"employees": [
{
"name": "John Smith",
"email": "john.smith@example.com",
"status": "Active",
"location": "New York",
"department": "Marketing",
"jobTitle": "Marketing Specialist",
"supervisor": "Jane Wilson"
},
{
"name": "Emily Johnson",
"email": "emily.johnson@example.com",
"status": "Inactive"
}
]
}
}
}'

Odpověď

Úspěšná odpověď

{
"data": {
"syncEmployees": {
"success": true
}
}
}

Chybová odpověď

{
"errors": [
{
"message": "You can only import up to 1000 employees at once."
}
]
}