Menu

Samenvatting van de Rippling API

De Rippling API stelt je in staat om je HR-, IT- en payroll-processen te integreren met externe bedrijfssystemen. Hiermee automatiseer je personeelsadministratie en zorg je voor één centrale bron van waarheid voor medewerkergegevens binnen je organisatie.
  • Medewerker- en worker-beheer: Haal medewerker- en worker-gegevens op voor onboarding, offboarding en identity-synchronisatie met je HRIS of IAM-tooling.
  • Organisatiestructuur: Beheer afdelingen, teams, titels, supergroups en functies vanuit één bron, en houd je org-chart consistent tussen systemen.
  • Aangepaste objecten en velden: Definieer en bevraag custom objects, custom object records en custom fields voor organisatie-specifieke data die niet in het standaardmodel past.
  • Zakelijke relaties: Koppel business partners en partner-groepen voor contractors, accountants en externe dienstverleners.
  • Werklocaties en identity: Haal kantoor- en werklocaties op en bevraag SSO- en entitlement-data voor veilige toegangsbeheer-integraties.
API Quick Facts REST
  • Authenticatie Bearer Token
  • Methods GET (116)POST (35)DELETE (18)PATCH (26)
  • Rate limits Maximaal 300 requests per IP per sliding window van 10 seconden (burst threshold). Overschrijding leidt tot een 10-seconden penalty-periode waarin alle requests 429 retourneren.
  • Webhooks Niet beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering Header-based

Laatste ontwikkelingen bij de Rippling API

Rippling bouwde haar REST API rondom een datumgebaseerd versioningmodel waarin elke breaking change een nieuwe versie krijgt via de Rippling-Api-Version-header of per API-token. Het API-oppervlak is de afgelopen jaren uitgebreid van basis-HR-data (workers, departments, teams) naar rijkere objectmodellen met supergroups, custom objects, custom object records en external_id lookup. Scopes bepalen welke endpoints een token kan aanspreken; machtigingen erven uit het permission profile van de maker. Bulk-endpoints voor custom object records en filter/expand/sort-parameters voor querying zijn latere toevoegingen waarmee je grotere datasets efficiënt kunt ophalen.

API versies

Date-based versioning

Rippling hanteert datumgebaseerde API-versies (bijv. Rippling-Api-Version: 2023-10-01). Breaking changes worden per datum vrijgegeven; upgraden kan door een nieuw API-token met de gewenste versie aan te maken of via de Rippling-Api-Version header.

Custom Objects Major release

Introductie van Custom Objects, Custom Object Records en Custom Object Fields voor organisatie-specifieke datamodellen. Bulk-create/update/delete en by-external-id lookup ondersteunen grootschalige synchronisaties.

Supergroups Major release

Supergroups-model voor het definiëren en beheren van groepen medewerkers via inclusion- en exclusion-members, bovenop de klassieke departments- en teams-concepten.