Menu

Samenvatting van de Sage People API

De Sage People API stelt organisaties in staat om hun HRIS-data te integreren met externe systemen. Omdat Sage People op het Salesforce-platform draait, loopt elke API-call via het eigen Salesforce-domein van de klant en respecteert het platform-native permissies en security.
  • Medewerkerbeheer: Haal gepagineerde lijsten of individuele employees op met filters op afdeling, preferred name, employment-status en overige attributen.
  • Salaris en bonus: Synchroniseer salary-records en bonus-data voor integratie met payroll-engines en compensation-management-tools.
  • Pay details: Voeg pay-details toe aan individuele medewerkers via POST op het employee/paydetails-endpoint voor geautomatiseerde payroll-berekeningen.
  • Verlof en absence-balances: Haal absences en absence-balances op voor verlof-tracking, verzuim-analyse en compliance-rapportages.
  • Timesheets: Synchroniseer timesheet-data naar je projectmanagement-tool, factuurgenerator of BI-dashboard.
  • Employee-change-webhooks: Configureer Named Credentials + Api Change Event Webhook (Custom Metadata Type) in Salesforce om real-time notificaties te ontvangen bij nieuwe of gewijzigde medewerkers.
API Quick Facts REST
  • Authenticatie OAuth2, Bearer Token
  • Methods GET (7)POST (1)
  • Rate limits Gelimiteerd door Salesforce-platform-limieten (per org, dagelijkse API-call-budget). Exacte Sage People-specifieke rate limits zijn niet gepubliceerd.
  • Webhooks Beschikbaar
  • Sandbox Beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de Sage People API

Sage People's SPAPI REST API is doorontwikkeld binnen het Salesforce Apex REST-framework, waarbij elke klant-org een eigen `{instance}.salesforce.com`-subdomein krijgt. De API is geƫvolueerd van alleen Employee-endpoints naar v4.8 met ondersteuning voor Absence, Absence Balance, Bonus, Salary en Timesheet. De API Breaking Change Policy biedt gecontroleerde deprecations en versie-overgangen. Authenticatie via Salesforce OAuth 2.0 en API-set permission-mapping zorgt voor fijnmazige toegangscontrole. Webhooks zijn toegevoegd als Custom Metadata-gebaseerde configuratie (Api Change Event Webhook), momenteel beperkt tot Employee-Change-events; notificaties bevatten alleen de Employee-ID en vereisen een vervolg-API-call voor detail.

API versies

v4.8 (Salesforce Apex REST) Major release

REST API op het Salesforce Apex REST-framework met endpoints voor Absence, Absence Balance, Bonus, Employee, Salary en Timesheet. Versie-prefix in URL (/spapi/v4).

Webhooks (Employee Changes)

Webhook-ondersteuning via Salesforce Named Credentials + Api Change Event Webhook (Custom Metadata Type). Momenteel beperkt tot Employee-create/update-events; payload bevat alleen Employee-ID.

Breaking Change Policy

Formele API Breaking Change Policy voor gecontroleerde deprecations en versie-overgangen, beschikbaar op developer.sage.com/people.