Voor ontwikkelaars
Koppel uw HRIS en ATS aan Paritir
Met de Integratie-API sturen uw systemen medewerker- en vacaturegegevens volgens schema naar Paritir, zodat de loonkloofanalyse op actuele gegevens draait zonder handmatige CSV-import. De API is gebouwd voor wie het integratiewerk doet: een adviesbureau, het IT-team van de klant of de eigen engineers van Paritir.
Wat de API doet
Drie taken, één API
Medewerkerbatches
Stuur medewerkerrecords in batches. Paritir koppelt elk record eerst op uw externe ID en daarna op e-mailadres, werkt bij wat is gewijzigd en leidt daaruit de salaris- en functiehistorie af, zodat u zelf nooit historie hoeft te sturen.
Wijs uw velden één keer toe
Stuur een paar voorbeeldrijen en Paritir stelt voor hoe uw HRIS-velden op die van Paritir aansluiten. Een mens bevestigt de toewijzing één keer en die wordt opgeslagen als bronprofiel. Latere synchronisaties passen haar toe zoals opgeslagen, en houden een batch tegen als de structuur van uw bron verandert.
Vacatures erin, compliance eruit
Stuur vacatures vanuit uw ATS. Paritir toetst elke vacature aan de regels voor beloningstransparantie van het land van uw hoofdkantoor, en u kunt het resultaat voor elke vacature terug opvragen.
Toegang
OAuth 2.0, beperkt tot één organisatie
Clientcredentials
Uw systeem wisselt een client-ID en secret in voor een toegangstoken. Tokens zijn 15 minuten geldig; vraag een nieuw token aan zodra het verloopt. Er zijn geen statische API-sleutels.
Eén organisatie per credential
Een token leest en schrijft alleen in de organisatie die de credential heeft uitgegeven. De organisatie volgt uit de credential, nooit uit het verzoek.
Alleen de scopes die u toekent
Elke credential heeft de scopes die bij het aanmaken zijn gekozen, zoals medewerkers schrijven of vacatures lezen. Een aanroep daarbuiten wordt geweigerd.
Aangemaakt en ingetrokken in de app
De eigenaar of beheerder van een organisatie maakt credentials aan onder Instellingen → Integraties. Het secret wordt één keer getoond en alleen als hash opgeslagen. Wordt een credential ingetrokken, dan werken de tokens ervan direct niet meer.
Haal een token op en stuur dan een batch
POST https://app.paritir.com/v1/oauth/token
Content-Type: application/json
{ "grant_type": "client_credentials",
"client_id": "ptir_…", "client_secret": "…" }
→ { "access_token": "…", "token_type": "Bearer",
"expires_in": 900, "scope": "workforce:write" }POST https://app.paritir.com/v1/employees:batch
Authorization: Bearer …
Idempotency-Key: …
Content-Type: application/json
{ "employees": [
{ "external_id": "E-1042", "full_name": "…", "email": "…" }
] }
→ { "sync_run_id": "…", "inserted": 1, "updated": 0,
"unchanged": 0, "errors": 0, … }Referentie
De endpoints die nu live zijn
Verzoeken en antwoorden zijn JSON. Elke aanroep wordt gelogd bij uw organisatie.
Basis-URL https://app.paritir.com/v1
| Methode | Pad | Scope | Functie |
|---|---|---|---|
| POST | /oauth/token | — | Clientcredentials inwisselen voor een toegangstoken van 15 minuten. |
| POST | /employees:batch | workforce:write | Medewerkers in één batch aanmaken of bijwerken. |
| POST | /employees:map-preview | workforce:write | Een veldtoewijzing voorstellen op basis van voorbeeldrijen. Schrijft niets weg. |
| POST | /postings:batch | postings:write | Vacatures in één batch aanmaken of bijwerken. |
| GET | /postings | postings:read | Vacatures met hun complianceresultaat tonen, nieuwste eerst. |
| GET | /postings/{posting_reference} | postings:read | Eén vacature opvragen via uw eigen referentie. |
Veilig opnieuw te verzenden
Stuur bij een batch een Idempotency-Key-header mee. Dezelfde sleutel opnieuw sturen levert het eerste resultaat op zonder opnieuw te schrijven; een sleutel waarvan de verwerking nog loopt, krijgt HTTP 409.
Paginering en filters
De vacaturelijst pagineert met limit en een ondoorzichtige cursor, en filtert op status en op updated_since.
Fouten en limieten
Fouten komen terug als JSON met een melding. Validatie noemt de foutieve velden en herhaalt nooit de waarden die u stuurde. Aanroepen zijn per organisatie aan een limiet gebonden; daarboven krijgt u HTTP 429.
Status
Wat de API nog niet doet
De API brengt gegevens binnen en geeft vacatures terug. Loonkloofresultaten, rapporten en gezamenlijke beloningsevaluaties blijven voorlopig in de app. Er zijn nog geen webhooks en geen sandboxomgeving, dus een nieuwe integratie wordt met onze hulp ingericht op een echte organisatie.
API-toegang hoort bij een account
Paritir werkt op uitnodiging zolang wij met onze eerste klanten en adviesbureaus samenwerken. Zodra uw organisatie is ingericht, kan de eigenaar of beheerder API-credentials aanmaken.